Janvia

入门

快速开始

三步跑通第一个任务:准备余额和 API 密钥、提交任务、取回结果。

1. 准备余额和 API 密钥

  1. 登录后在 价格 页充值。余额按美元计,不会过期。
  2. 在控制台的 API 密钥 页创建一个密钥。密钥只显示一次,请妥善保存,不要写进网页或 App 的代码里。

想先看看效果,可以打开任意 模型页,用「在线试用」直接生成。在线试用和 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,任务结束后我们把结果推送给你,见 回调通知。

失败的任务不收费,已扣的钱全额退回。