Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.lemondata.cc/llms.txt

Use this file to discover all available pages before exploring further.

Vue d’ensemble

Utilisez cet endpoint pour un polling async unifié entre différents types de tâches tels que la génération de vidéo, d’image, de musique et de 3D. Si une réponse de création inclut poll_url, appelez ce chemin exact. Pour les workflows async plus récents, poll_url peut pointer vers /v1/tasks/{taskId}.

Paramètres de chemin

taskId
string
requis
L’ID de tâche renvoyé par la requête de création.

Réponse

id
string
Identifiant de la tâche.
status
string
Statut de la tâche, par exemple pending, processing, completed ou failed. Les tâches annulées sont représentées comme failed avec cancelled: true.
cancelled
boolean
true lorsqu’une tâche asynchrone en file d’attente a été annulée avant l’exécution.
cancellation_status
string
Marqueur d’annulation. Présent avec la valeur cancelled lorsque l’annulation réussit.
data
array
Pour les tâches d’image terminées, les résultats générés sont renvoyés ici. Les tâches d’image renvoient des URL dans data[].url.
video_url
string
URL de l’asset de résultat lorsque la tâche est terminée et produit une vidéo.
error
string
Message d’erreur lorsque la tâche échoue.

Comportement d’erreur

Si la tâche n’existe plus, a expiré ou ne peut pas être résolue via le contrat public async-task, LemonData renvoie :
{
  "error": {
    "message": "Task not found or no longer available.",
    "type": "invalid_request_error",
    "code": "async_task_not_found"
  }
}

Exemples

curl "https://api.lemondata.cc/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"
Python
import requests

poll_url = "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
response = requests.get(
    f"https://api.lemondata.cc{poll_url}",
    headers={"Authorization": "Bearer sk-your-api-key"},
)
print(response.json())
JavaScript
const pollUrl = '/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa';
const response = await fetch(`https://api.lemondata.cc${pollUrl}`, {
  headers: { Authorization: 'Bearer sk-your-api-key' },
});
console.log(await response.json());