获取任务信息

查询所有模型生成任务的状态与结果。

curl --request GET \
  --url https://api.crun.ai/api/v1/client/job/TaskInfo \
  --header 'x-api-key: <api-key>'

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "d6956973-2f17-43d4-8514-af6cc3a2f55d",
    "provider": "Google",
    "model_version": "nano-banana",
    "status": "running",
    "param": {
      "model": "google/nano-banana",
      "callback_url": null,
      "input": {
        "prompt": "A scene of urban fantasy art. A dynamic graffiti art character. A teenager, painted with ...",
        "output_format": "png",
        "aspect_ratio": "16:9"
      }
    },
    "create_at": 1768900378,
    "result": null,
    "duration_s": null,
    "complete_at": null,
    "source": "api"
  }
}

GET

api

client

job

TaskInfo

查询所有模型生成任务的状态与结果。

curl --request GET \
  --url https://api.crun.ai/api/v1/client/job/TaskInfo \
  --header 'x-api-key: <api-key>'

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "d6956973-2f17-43d4-8514-af6cc3a2f55d",
    "provider": "Google",
    "model_version": "nano-banana",
    "status": "running",
    "param": {
      "model": "google/nano-banana",
      "callback_url": null,
      "input": {
        "prompt": "A scene of urban fantasy art. A dynamic graffiti art character. A teenager, painted with ...",
        "output_format": "png",
        "aspect_ratio": "16:9"
      }
    },
    "create_at": 1768900378,
    "result": null,
    "duration_s": null,
    "complete_at": null,
    "source": "api"
  }
}

API 端点

GET https://api.crun.ai/api/v1/client/job/TaskInfo

该端点用于查询通过 /api/v1/client/job/CreateTask 接口创建的任务执行状态，并获取任务结果。它提供统一的查询接口，兼容模型分类下的所有模型，无论底层模型如何，均可一致地进行任务追踪与结果获取。

查询参数

task_id

string

必填

创建任务时返回的唯一任务标识符。示例：task_12345678

请求示例

curl -X GET "https://api.crun.ai/api/v1/client/job/TaskInfo?task_id=task_12345678" \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json"

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "d6956973-2f17-43d4-8514-af6cc3a2f55d",
    "provider": "Google",
    "model_version": "nano-banana",
    "status": "running",
    "param": {
      "model": "google/nano-banana",
      "callback_url": null,
      "input": {
        "prompt": "A scene of urban fantasy art. A dynamic graffiti art character. A teenager, painted with ...",
        "output_format": "png",
        "aspect_ratio": "16:9"
      }
    },
    "create_at": 1768900378,
    "result": null,
    "duration_s": null,
    "complete_at": null,
    "source": "api"
  }
}

响应格式

code

integer

响应状态码。200 表示请求已成功处理（任务已找到并返回，与执行结果无关）。

message

string

响应消息，通常为 "success"。

data

object

包含所有任务信息的任务数据对象。

显示 data 属性

task_id

string

任务的唯一标识符。

provider

string

模型提供商名称。示例：Google、Wan、Bytedance

model_version

string

创建任务时使用的具体模型版本。

status

string

任务当前状态。详见下方任务状态枚举。可能的值：pending、running、success、failed

param

object

创建任务时使用的原始参数。

显示 param 属性

model

string

创建任务时使用的模型标识符。

callback_url

string | null

为该任务配置的 Webhook 回调 URL。

input

object

模型特定的输入参数，其结构因所选模型而异。

result

object | null

任务生成结果。仅当任务状态为 success 或 failed 时返回有效值；否则返回 null。

显示 param 属性

code

integer

任务生成结果状态码。200 表示生成成功，非 200 值表示生成失败。

message

string

任务成功或失败的说明信息。

media_urls

array<string>

任务生成的媒体 URL 列表。仅当任务状态为 success 时返回。

create_at

integer

任务创建时间的 Unix 时间戳（秒）。

complete_at

integer | null

任务完成时间的 Unix 时间戳（毫秒）。任务未完成时为 null。

duration_s

integer | null

任务执行时长（秒）。任务未完成时为 null。

source

string

任务创建来源。

任务状态枚举

状态	描述	操作建议
`pending`	任务已入队，等待处理	继续轮询
`running`	任务正在处理中	继续轮询
`success`	任务成功完成	访问 result.media_url 获取结果
`failed`	任务失败	访问 result 对象查看错误码和错误信息

获取任务结果的最佳实践

推荐轮询间隔

轮询间隔：建议轮询间隔设置为 15 至 30 秒
动态调整间隔：对于长时间运行的视频生成任务，建议动态增加轮询间隔
延迟首次轮询：首次状态检查前至少等待一个轮询间隔，以减少不必要的请求
最大轮询时长：超过 15-20 分钟后应停止并进行排查

过于频繁的轮询可能导致请求被限速。生产环境建议使用回调方式。

使用回调代替轮询

对于生产环境应用，我们强烈建议在创建任务时使用 callback_url 参数：

无需轮询：服务器自动接收通知
降低 API 成本：避免持续的轮询请求
性能更优：任务完成后立即收到通知
减少延迟：完成与通知之间无延迟

推荐使用此方式

处理已完成的任务

当 status 为 success 时：

从响应的 result 字段获取任务结果
从 result.media_urls 中提取生成的媒体 URL
将媒体文件下载至您自己的存储空间
将结果元数据持久化至您的存储或数据库

重要提示：生成的媒体 URL 通常在 14 天后永久删除

常见错误码

错误码	描述	解决方案
`401`	未授权 - API 密钥无效或缺失	检查您的 API 密钥
`404`	任务未找到	验证 task_id 是否正确
`429`	超出请求频率限制	降低请求频率
`500`	服务器内部错误	几分钟后重试
`501`	生成失败	查看 `result` 对象获取错误码和错误信息

频率限制

最大查询速率：每账号每秒最多 15 次请求
推荐间隔：每次轮询间隔 15-30 秒

模型概览

探索所有可用模型

获取账户额度

查看您的剩余积分

授权

x-api-key

string

header

必填

所有 API 均需通过 API Key 进行身份验证。

获取 API Key：

访问 API Key 管理页面获取您的 API Key

使用方式：将以下内容添加至请求头：

x-api-key: YOUR_API_KEY

注意事项：

请妥善保管您的 API Key，切勿与他人共享
若怀疑 API Key 已泄露，请立即在管理页面进行重置

查询参数

task_id

string

必填

用于获取任务结果的任务 ID。

Required string length: 36

示例:

"task_1234567"

响应

任务信息获取成功或任务未找到。

code

integer

必填

响应状态码

200: 成功 - 请求已成功处理
401: 未授权 - 身份凭证缺失或无效
402: 额度不足 - 账户余额不足以完成本次操作
404: 未找到 - 请求的资源或端点不存在
422: 验证错误 - 请求参数未通过验证
429: 请求限速 - 该资源的请求次数已超出限制
455: 服务不可用 - 系统正在维护中
500: 服务器错误 - 处理请求时发生意外错误
501: 生成失败 - 内容生成任务失败
505: 功能已禁用 - 所请求的功能当前已被禁用

message

string

必填

响应消息

data

object

任务记录及结果信息。

Show child attributes

Qwen TTS 音色设计

​API 端点

​查询参数

​请求示例

​响应格式

​任务状态枚举

​获取任务结果的最佳实践

​常见错误码

​频率限制

​相关资源

模型概览

获取账户额度

授权

查询参数

响应

API 端点

查询参数

请求示例

响应格式

任务状态枚举

获取任务结果的最佳实践

常见错误码

频率限制

相关资源