API de Réponses

Grâce à l’endpoint /v1/answers d’Olostep, tu peux rechercher sur le web avec un 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 baser tes produits sur des données et des sources du monde réel, 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 recevoir

Cela 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 emails) 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 :

Baser les applications IA sur des données et des faits du monde réel
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 dans le 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 les autres endpoints d’Olostep, tu recevras un objet answer en réponse. L’objet answer a 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 dans le 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 veux.
Si l’agent n’est pas confiant, 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"
}

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

Tarification

​Cas d’utilisation

​Installation

​Utilisation

​Réponse

​Paramètre json flexible

​Tarification

Cas d’utilisation

Installation

Utilisation

Réponse

Paramètre `json` flexible

Tarification