GET
https://api.yuannengai.com
/
v1
/
tasks
/
{task_id}
curl --request GET \
  --url https://api.yuannengai.com/v1/tasks/task_01K8SGYNNNVBQTXNR4MM964S7K \
  --header 'Authorization: Bearer <token>'

{
  "code": 200,
  "data": {
    "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K",
    "status": "processing",
    "progress": 50,
    "created_at": "2024-01-01T12:00:00Z"
  }
}
  • 用于查询图像、视频等异步任务的状态
  • 返回任务进度和最终结果
  • 生成的资源链接有效期为24小时
curl --request GET \
  --url https://api.yuannengai.com/v1/tasks/task_01K8SGYNNNVBQTXNR4MM964S7K \
  --header 'Authorization: Bearer <token>'

{
  "code": 200,
  "data": {
    "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K",
    "status": "processing",
    "progress": 50,
    "created_at": "2024-01-01T12:00:00Z"
  }
}

​
认证方式

​
Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key：访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY

​
路径参数

​
task_id
string
必填
任务ID提交图像或视频生成请求时返回的任务标识符

​
响应参数

​
code
integer
响应状态码
​
data
object
任务数据

​
轮询建议

建议使用以下策略轮询任务状态：
  1. 初始间隔：2秒
  2. 图像任务：每 2-5 秒轮询一次
  3. 视频任务：每 5-10 秒轮询一次
  4. 最大等待时间：图像 5 分钟，视频 30 分钟
import time
import requests

def wait_for_task(task_id, max_wait=300, interval=3):
    """等待任务完成"""
    start_time = time.time()
    
    while time.time() - start_time < max_wait:
        response = requests.get(
            f"https://api.yuannengai.com/v1/tasks/{task_id}",
            headers={"Authorization": "Bearer <token>"}
        )
        
        data = response.json()["data"]
        status = data["status"]
        
        if status == "completed":
            return data["result"]
        elif status == "failed":
            raise Exception(data["error"]["message"])
        
        time.sleep(interval)
    
    raise TimeoutError("任务超时")