curl --request POST \
--url https://api.ruxa.ai/api/v1/tasks/create \
--header 'Authorization: Bearer sk-xxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"callback_url": "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"
}
}
OpenAI
GPT-4o Image
基于 OpenAI GPT-4o 的图像生成模型 API 接口
POST
/
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 '{
"callback_url": "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 图像生成模型。查询任务状态
提交任务后，可通过统一的查询端点查看任务进度并获取生成结果：获取任务详情
了解如何查询任务状态并获取生成结果
生产环境中，建议使用
callback_url
参数接收生成完成的自动通知，而非轮询状态端点。授权
string
必填
Bearer Token 认证。格式：
Bearer sk-xxxxxx隐藏 详细说明
隐藏 详细说明
- 获取 API Key：访问 API Key 管理页面 获取您的 API Key
-
使用方法：在请求头中添加
Authorization: Bearer YOUR_API_KEY - 注意事项：请妥善保管您的 API Key，切勿泄露给他人
- 若怀疑 API Key 泄露，请立即在管理页面重置
请求体
请求体格式为application/json。
string
默认值:"gpt-4o-image"
必填
模型名称，固定为
gpt-4o-imagestring
任务完成后的回调地址。系统会向该 URL POST 任务状态与结果。示例：
https://your-domain.com/api/callbackobject
必填
响应
integer
必填
响应状态码
隐藏 状态码说明
隐藏 状态码说明
-
200: 成功 - 请求已处理完成 -
401: 未授权 - 身份验证凭据缺失或无效 -
402: 积分不足 - 账户积分不足以执行该操作 -
404: 未找到 - 请求的资源或端点不存在 -
422: 验证错误 - 请求参数未通过校验 -
429: 速率限制 - 已超出该资源的请求频次限制 -
500: 服务器错误 - 处理请求时发生意外故障
string
必填
响应消息，请求失败时为错误描述
curl --request POST \
--url https://api.ruxa.ai/api/v1/tasks/create \
--header 'Authorization: Bearer sk-xxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"callback_url": "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"
}
}