向任意支持的 AI 模型提交生成任务。
POST https://api.apixo.ai/api/v1/generateTask/{model}
{model} 替换为模型 ID（如 nano-banana、flux-2、sora-2、midjourney）。
请求头
Bearer token 用于 API 认证。格式：Bearer YOUR_API_KEY
请求体
获取结果的方式。async 表示通过状态接口轮询，callback 表示通过 webhook 投递。
接收结果的 webhook URL。当 request_type 为 callback 时必填。必须为可公开访问的 HTTPS URL，且在 30 秒内返回 HTTP 200。详见 Webhooks。 模型相关生成参数。
生成模式（如 text-to-image、image-to-image、text-to-video）。
编辑模式（如 image-to-image）的参考图片。
{
"code": 200,
"message": "success",
"data": {
"taskId": "task_abc123xyz789"
}
}
请保存 taskId，之后查询状态或调试时需要用到。
异步模式（轮询）
curl -X POST https://api.apixo.ai/api/v1/generateTask/nano-banana \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"request_type": "async",
"input": {
"mode": "text-to-image",
"prompt": "A futuristic city at sunset",
"aspect_ratio": "16:9"
}
}'
const response = await fetch('https://api.apixo.ai/api/v1/generateTask/nano-banana', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
request_type: 'async',
input: {
mode: 'text-to-image',
prompt: 'A futuristic city at sunset',
aspect_ratio: '16:9',
},
}),
});
const { data } = await response.json();
console.log('Task ID:', data.taskId);
import requests
response = requests.post(
'https://api.apixo.ai/api/v1/generateTask/nano-banana',
headers={
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
json={
'request_type': 'async',
'input': {
'mode': 'text-to-image',
'prompt': 'A futuristic city at sunset',
'aspect_ratio': '16:9',
},
}
)
task_id = response.json()['data']['taskId']
print(f'Task ID: {task_id}')
回调模式（Webhooks）
curl -X POST https://api.apixo.ai/api/v1/generateTask/nano-banana \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"request_type": "callback",
"callback_url": "https://your-server.com/webhook/apixo",
"input": {
"mode": "text-to-image",
"prompt": "A futuristic city at sunset",
"aspect_ratio": "16:9"
}
}'
const response = await fetch('https://api.apixo.ai/api/v1/generateTask/nano-banana', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
request_type: 'callback',
callback_url: 'https://your-server.com/webhook/apixo',
input: {
mode: 'text-to-image',
prompt: 'A futuristic city at sunset',
aspect_ratio: '16:9',
},
}),
});
response = requests.post(
'https://api.apixo.ai/api/v1/generateTask/nano-banana',
headers={
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
json={
'request_type': 'callback',
'callback_url': 'https://your-server.com/webhook/apixo',
'input': {
'mode': 'text-to-image',
'prompt': 'A futuristic city at sunset',
'aspect_ratio': '16:9',
},
}
)
错误响应
| Code | Description |
|---|
400 | 请求参数无效 |
401 | API 密钥无效或缺失 |
403 | 权限不足 |
429 | 超过速率限制 |
500 | 服务器错误 |