跳转到主要内容

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} 下返回基于任务的响应。

​
路径参数

​
id
string
必填
由 create 请求返回的任务 ID。

​
响应

​
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
可用时任务使用的模型。

​
错误行为

如果任务不再存在、已过期或无法通过公共异步任务契约解析，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());