跳转到主要内容
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": "背景变成像素风",
      "size": "2:3",
      "image": "https://example.com/your-image.png"
    },
    "model": "gpt-4o-image"
  }'

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_gpt-4o-image_1766304530229_cf4dafd2"
  }
}
gpt-4o-image 底层调用的是 OpenAI 的 gpt-4o 图像生成模型。

​
查询任务状态

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

获取任务详情

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

​
授权

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

​
请求体

请求体格式为 application/json。
​
model
string
默认值:"gpt-4o-image"
必填
模型名称，固定为 gpt-4o-image
​
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": "背景变成像素风",
      "size": "2:3",
      "image": "https://example.com/your-image.png"
    },
    "model": "gpt-4o-image"
  }'

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_gpt-4o-image_1766304530229_cf4dafd2"
  }
}