入门
快速开始
三步跑通第一个任务:准备余额和 API 密钥、提交任务、取回结果。
1. 准备余额和 API 密钥
想先看看效果,可以打开任意 模型页,用「在线试用」直接生成。在线试用和 API 调用一样从余额扣费。
2. 提交任务
图片、视频、音频模型都用同一个接口。提交后马上返回任务 ID,生成在后台进行:
curl https://janvia.io/v1/tasks \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"input": { "prompt": "a red fox in the snow", "resolution": "2K" }
}'返回 HTTP 202,内容是任务对象,status 为 queued。model 和 input 能填什么,看各 模型页 的「参数」,或 模型与参数。
3. 取回结果
轮询任务,直到 status 变成 completed 或 failed:
curl https://janvia.io/v1/tasks/TASK_ID \ -H "Authorization: Bearer $API_KEY"
完成后,output.files 里是生成的文件,每个文件有 url、type 和 mime_type。
不想轮询的话,提交时传 callback_url,任务结束后我们把结果推送给你,见 回调通知。
失败的任务不收费,已扣的钱全额退回。