genkiln

快速开始

几分钟内创建 API Key、提交第一个图像或视频生成任务并拿到结果。

genkiln 是一个 AI 图像与视频生成的 REST API。你提交任务，我们在后台异步执行，你可以轮询结果，也可以通过签名 Webhook 接收结果。无论选哪个模型，请求格式都一样。

所有接口都在同一个 Base URL 下：

Text
https://genkiln.com/v1

1. 获取 API Key

  1. 注册账号，在定价页充值积分。1 积分 = 0.001 美元。
  2. 打开控制台 → API Keys 创建 Key。Key 以 sk_ 开头，只显示一次，请妥善保存。
cURL
export GENKILN_API_KEY="sk_..."

Key 只能放在你的服务器上，不要写进网页或移动端 App 代码。详见鉴权。

2. 创建任务

调用 POST /v1/tasks，传入 model 和该模型的 input。下面的例子用 Nano Banana 2 生成一张 1K 图片：

curl https://genkiln.com/v1/tasks \
  -H "Authorization: Bearer $GENKILN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "input": {
      "prompt": "A red fox running through fresh snow, golden hour, 35mm photo",
      "aspect_ratio": "16:9",
      "resolution": "1K"
    }
  }'

接口立即返回 202 Accepted 和任务对象，此时积分已经扣除：

JSON
{
  "id": "task_01JC8ZK3Q4XG7T2M9V5R6N8W1B",
  "object": "task",
  "model": "nano-banana-2",
  "status": "queued",
  "cost_credits": 52,
  "refunded": false,
  "output": null,
  "error": null,
  "created_at": "2026-11-03T08:00:00.000Z",
  "started_at": null,
  "completed_at": null,
  "expires_at": null,
  "metadata": {}
}

3. 获取结果

每隔几秒调用一次 GET /v1/tasks/{id}，直到 status 变为 succeeded、failed 或 canceled：

curl https://genkiln.com/v1/tasks/task_01JC8ZK3Q4XG7T2M9V5R6N8W1B \
  -H "Authorization: Bearer $GENKILN_API_KEY"

成功的任务会返回我们 CDN 上的文件地址：

JSON
{
  "id": "task_01JC8ZK3Q4XG7T2M9V5R6N8W1B",
  "object": "task",
  "model": "nano-banana-2",
  "status": "succeeded",
  "cost_credits": 52,
  "refunded": false,
  "output": {
    "images": [{ "url": "https://cdn.genkiln.com/results/.../0.png" }],
    "videos": []
  },
  "error": null,
  "created_at": "2026-11-03T08:00:00.000Z",
  "started_at": "2026-11-03T08:00:04.000Z",
  "completed_at": "2026-11-03T08:00:21.000Z",
  "expires_at": "2026-12-03T08:00:21.000Z",
  "metadata": {}
}

结果文件在任务完成后保存 30 天（见 expires_at），之后会被删除。需要长期保存的文件请及时下载。

也可以不轮询：创建任务时传入 callback_url，任务完成后我们会把任务对象 POST 给你。详见 Webhooks。

计费方式

  • 每个模型都有固定、公开的价格：按张、按条或按视频秒数计费。见模型。
  • 费用根据你的输入参数计算，创建任务时以 cost_credits 返回。
  • 任务失败、超时或被取消时，积分自动退回余额，任务上显示 "refunded": true。
  • 充值的积分永不过期。

下一步

  • 创建任务：全部请求字段、幂等与校验规则。
  • Webhooks：用回调代替轮询，并校验签名。
  • 错误：所有错误码及处理方式。