メインコンテンツへスキップ

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.

​
概要

このエンドポイントは、動画、画像、音楽、3D生成などのタスクタイプにまたがる統一された非同期ポーリングに使用します。 create レスポンスに poll_url が含まれている場合は、正確にそのパスを呼び出してください。画像モデルの中には、タスクベースのレスポンスを画像専用のステータスパス、または /v1/tasks/{id} のいずれかで返すものがあります。

​
Path Parameters

​
id
string
必須
create リクエストが返すタスクID。

​
Response

​
id
string
標準的な非同期タスク識別子。
​
task_id
string
非同期タスク識別子の別名。
​
poll_url
string
create レスポンスが提供する場合の推奨ポーリングURL。
​
status
string
タスクステータス。pending、processing、completed、failed などです。キャンセルされたタスクは failed として表され、cancelled: true が付きます。
​
cancelled
boolean
キュー中の非同期タスクが実行前にキャンセルされた場合は true です。
​
cancellation_status
string
キャンセルマーカー。キャンセル成功時は cancelled です。
​
data
array
完了した画像タスクでは、生成された画像結果がここに返されます。画像タスクは data[].url に URL を返します。
​
progress
number
利用可能な場合の進行度（パーセンテージ）。
​
video_url
string
タスクが完了して動画を生成した場合の結果アセットのURL。
​
video
object
利用可能な場合に url, duration, width, height を含む単一の動画ペイロード。
​
videos
array
上流が複数出力を返す場合の複数の動画ペイロード。
​
error
string
タスクが失敗したときのエラーメッセージ。
​
created
integer
利用可能な場合の作成タイムスタンプ。
​
updated
integer
利用可能な場合の最終更新タイムスタンプ。
​
model
string
利用可能な場合にタスクで使用されたモデル。

​
エラー時の挙動

タスクが存在しない、期限切れ、または公開されている async-task 契約を通じて解決できない場合、LemonData は次を返します: 
{
  "error": {
    "message": "Task not found or no longer available.",
    "type": "invalid_request_error",
    "code": "async_task_not_found"
  }
}

​
例

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());