API de Réponses

Grâce à l’endpoint Olostep /v1/answers, tu peux rechercher sur le web en langage naturel et obtenir des réponses et des données alimentées par l’IA dans le format JSON que tu souhaites. Cela te permet de fonder tes produits sur des données et des sources réelles, d’enrichir des points de données ou des feuilles de calcul.

Pose une question ou donne à l’IA un point de données que tu souhaites enrichir
Optionnel : spécifie la structure JSON que tu souhaites obtenir en retour

Il va :

Rechercher, nettoyer, valider et retourner les données trouvées sur le Web
Retourner les sources utilisées pour générer la réponse
Gérer l’incertitude avec des valeurs NOT_FOUND lorsque les données ne peuvent pas être vérifiées

Pour les détails de l’API, consulte la Référence de l’API de l’Endpoint Réponses. Par défaut, nous utilisons un index web générique et un validateur LLM économique. Les clients d’entreprise ont accès à des index web propriétaires spécifiques à l’industrie, des données privées exclusives (y compris les numéros de téléphone et les e-mails) et des modèles LLM personnalisés les mieux adaptés à leur cas d’utilisation. Contacte-nous pour l’accès : info@olostep.com

Cas d’utilisation

L’endpoint de réponses peut être utilisé pour :

Fonder des applications IA sur des données et des faits réels
Enrichir des feuilles de calcul et des points de données pour le Recrutement, la Finance, le Conseil et les Ventes

Voici une démonstration d’une feuille de calcul alimentée par l’IA grâce à l’endpoint Réponses : https://www.olostep.com/demos/spreadsheet-enrich

Installation

pip install olostep

npm install olostep

# curl est disponible par défaut sur macOS, Linux et Windows

npm install node-fetch

pip install requests

Utilisation

Pose une question et passe un schéma JSON pour guider la sortie. Tu peux aussi ne pas passer le paramètre json et l’API retournera un objet json avec le texte de la réponse à l’intérieur du champ result.

from olostep import Olostep

client = Olostep(api_key="YOUR_REAL_KEY")

answer = client.answers.create(
    task="Quel est le dernier livre de J.K. Rowling ?",
    json_format={"book_title": "", "author": "", "release_date": ""},
)

print(answer.json_content)
print(answer.sources)

import Olostep from 'olostep'

const client = new Olostep({ apiKey: 'YOUR_REAL_KEY' })

const answer = await client.answers.create({
  task: 'Quel est le dernier livre de J.K. Rowling ?',
  jsonFormat: { book_title: '', author: '', release_date: '' },
})

console.log(answer.json_content)
console.log(answer.sources)

curl -s -X POST "https://api.olostep.com/v1/answers" \
  -H "Authorization: Bearer $OLOSTEP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "Quel est le dernier livre de J.K. Rowling ?",
    "json": {"book_title": "", "author": "", "release_date": ""}
  }'

olostep answer "Quel est le dernier livre de J.K. Rowling ?" \
  --json-format '{"book_title":"","author":"","release_date":""}'

const res = await fetch('https://api.olostep.com/v1/answers', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer <YOUR_API_KEY>', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    task: 'Quel est le dernier livre de J.K. Rowling ?',
    json: { book_title: '', author: '', release_date: '' }
  })
})
console.log(await res.json())

import requests, json

endpoint = "https://api.olostep.com/v1/answers"
payload = {
  "task": "Quel est le dernier livre de J.K. Rowling ?",
  "json": {"book_title": "", "author": "", "release_date": ""}
}
headers = {"Authorization": "Bearer <YOUR_API_KEY>", "Content-Type": "application/json"}

response = requests.post(endpoint, json=payload, headers=headers)
print(json.dumps(response.json(), indent=2))

Réponse

Comme pour d’autres endpoints Olostep, tu recevras un objet answer en réponse. L’objet answer possède quelques propriétés comme id et result.

{
  "id": "answer_9bi0sbj9xa",
  "object": "answer",
  "created": 1760327323,
  "metadata": {},
  "task": "Quel est le dernier livre de J.K. Rowling ?",
  "result": {
    "json_content": "{\"book_title\":\"The Hallmarked Man\",\"author\":\"J.K. Rowling (as Robert Galbraith)\",\"release_date\":\"2 September 2025\"}",
    "json_hosted_url": "https://olostep-storage.s3.us-east-1.amazonaws.com/answer_9bi0sbj9xa.json",
    "sources": [
      "https://strikefans.com/the-books/",
      "https://www.facebook.com/groups/496943608606523/posts/1136830134617864/",
      "https://robert-galbraith.com/strike-books/",
      "https://www.novelsuspects.com/series-list/robert-galbraith-cormoran-strike-series-in-order/",
      "https://www.reddit.com/r/books/comments/1na833a/jk_rowlings_new_strike_novel_900_pages_of_romance/",
      "https://www.harrypotter.com/writing-by-jk-rowling",
      "https://stories.jkrowling.com/book-news/",
      "https://deadline.com/2024/09/jk-rowling-writing-futuristic-novel-1236093909/",
      "https://www.reddit.com/r/FantasticBeasts/comments/1cl1shn/jk_rowling_may_2024_ive_got_six_more_books_in_my/",
      "https://www.jkrowling.com/news/"
    ]
  }
}

La réponse demandée, formatée selon le paramètre json, se trouve dans response.result.json_content et la liste des sources dans response.result.sources. Tu peux analyser le JSON sous forme de chaîne pour accéder aux données structurées.

{
  "book_title": "The Hallmarked Man",
  "author": "J.K. Rowling",
  "release_date": "2 septembre 2025"
}

Exemple de sources :

[
    "https://www.harrypotter.com/writing-by-jk-rowling",
    "https://stories.jkrowling.com/book-news/",
    "https://deadline.com/2024/09/jk-rowling-writing-futuristic-novel-1236093909/",
    "https://www.reddit.com/r/FantasticBeasts/comments/1cl1shn/jk_rowling_may_2024_ive_got_six_more_books_in_my/",
    "https://www.jkrowling.com/news/"
]

Lorsque tu ne passes pas le paramètre json, l’API retournera un objet json avec le texte de la réponse à l’intérieur du champ result.

{
  "result": "Le dernier livre de J.K. Rowling est The Hallmarked Man."
}

Paramètre `json` flexible

Fournis un objet JSON avec des valeurs vides comme schéma, ou une chaîne décrivant les données que tu souhaites.
Si l’agent n’est pas sûr, il retourne NOT_FOUND pour ce champ.

from olostep import Olostep

client = Olostep(api_key="YOUR_REAL_KEY")

answer = client.answers.create(
    task="Quand React 30 sera-t-il publié ?",
    json_format={"release_date": ""},
)

print(answer.json_content)

import Olostep from 'olostep'

const client = new Olostep({ apiKey: 'YOUR_REAL_KEY' })

const answer = await client.answers.create({
  task: 'Quand React 30 sera-t-il publié ?',
  jsonFormat: { release_date: '' },
})

console.log(answer.json_content)

import requests, json

endpoint = "https://api.olostep.com/v1/answers"
payload = {
  "task": "Quand React 30 sera-t-il publié ?", 
  "json": {
    "release_date": ""
  }
}
headers = {
  "Authorization": "Bearer <YOUR_API_KEY>",
  "Content-Type": "application/json"
}
response = requests.post(endpoint, json=payload, headers=headers)
print(json.dumps(response.json(), indent=2))

olostep answer "Quand React 30 sera-t-il publié ?" --json-format '{"release_date":""}'

Cela retournerait :

{
  "release_date": "NOT_FOUND"
}

Stockage

Les fichiers stockés pour une réponse sont conservés pendant 7 jours par défaut. Passe un objet storage sur POST /v1/answers pour les conserver plus longtemps, ou indéfiniment. Le paramètre couvre le résultat de la réponse et les pages récupérées pour la construire.

Paramètre	Type	Défaut	Description
`storage.expires_in`	`string`	`7d`	Durée de conservation des fichiers stockés. L’un de `7d`, `10d`, `30d`, `60d`, `90d`, `180d`, `365d`, ou `never` (indéfini).

Omettre storage, ou envoyer storage sans expires_in, utilise 7d. La réponse de création et GET /v1/answers/{answer_id} incluent la valeur en vigueur :

"storage": { "expires_in": "30d" }

cURL

curl -s -X POST "https://api.olostep.com/v1/answers" \
  -H "Authorization: Bearer $OLOSTEP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "Quelle est la dernière version stable de PostgreSQL ?",
    "storage": { "expires_in": "30d" }
  }'

Une valeur invalide retourne 400 :

{
  "type": "invalid_request_error",
  "message": "Invalid storage.expires_in. Allowed values: \"7d\", \"10d\", \"30d\", \"60d\", \"90d\", \"180d\", \"365d\", \"never\".",
  "code": "invalid_storage_expires_in"
}

Tarification

Les réponses coûtent 20 crédits par requête.

Commencer

Fonctionnalités

Solde et Facturation

Cas d’utilisation

Installation

Utilisation

Réponse

Paramètre `json` flexible

Stockage

Tarification

​Cas d’utilisation

​Installation

​Utilisation

​Réponse

​Paramètre json flexible

​Stockage

​Tarification

Cas d’utilisation

Installation

Utilisation

Réponse

Paramètre `json` flexible

Stockage

Tarification