跳转到主要内容
POST
https://api.ruxa.ai
/
api
/
v1
/
tasks
/
create
curl --request POST \
  --url https://api.ruxa.ai/api/v1/tasks/create \
  --header 'Authorization: Bearer sk-xxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "callBackUrl": "https://your-domain.com/api/callback",
    "input": {
      "prompt": "让画面动起来",
      "input_reference_url": "https://example.com/your-image.png",
      "seconds": "10",
      "aspect_ratio": "16:9",
      "enhance_prompt": true,
      "enable_upsample": false
    },
    "model": "veo3"
  }'

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_veo3_1766304530229_cf4dafd2"
  }
}
veo3 底层调用的是 Google 的 Veo3 视频生成模型，支持文生视频和图生视频。

​
查询任务状态

提交任务后，可通过统一的查询端点查看任务进度并获取生成结果：

获取任务详情

了解如何查询任务状态并获取生成结果
生产环境中，建议使用 callBackUrl 参数接收生成完成的自动通知，而非轮询状态端点。

​
授权

​
Authorization
string
必填
Bearer Token 认证。格式：Bearer sk-xxxxxx

​
请求体

请求体格式为 application/json。
​
model
string
默认值:"veo3"
必填
模型名称，固定为 veo3
​
callBackUrl
string
任务完成后的回调地址。系统会向该 URL POST 任务状态与结果。示例：https://your-domain.com/api/callback
​
input
object
必填
生成任务的输入参数

​
响应

​
code
integer
必填
响应状态码
​
message
string
必填
响应消息，请求失败时为错误描述
​
data
object
必填
curl --request POST \
  --url https://api.ruxa.ai/api/v1/tasks/create \
  --header 'Authorization: Bearer sk-xxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "callBackUrl": "https://your-domain.com/api/callback",
    "input": {
      "prompt": "让画面动起来",
      "input_reference_url": "https://example.com/your-image.png",
      "seconds": "10",
      "aspect_ratio": "16:9",
      "enhance_prompt": true,
      "enable_upsample": false
    },
    "model": "veo3"
  }'

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_veo3_1766304530229_cf4dafd2"
  }
}