Models

Prices are in credits; 1 credit = US$0.001. The price list is the same for every account and is fixed on our side. The cost of each task is returned as cost_credits when you create it.

Catalog#

List models from the API#

GET /v1/models returns every model that is currently available, with its prices and the JSON Schema of its input. No API key is needed.

curl https://genkiln.com/v1/models

{
  "object": "list",
  "data": [
    {
      "id": "nano-banana-2",
      "object": "model",
      "name": "Nano Banana 2",
      "vendor": "Google",
      "media_type": "image",
      "modes": ["text-to-image", "image-to-image"],
      "description": "Google's fast image model for generation and editing ...",
      "available": true,
      "pricing": [
        { "label": "1K", "unit": "image", "credits": 52, "usd": 0.052 },
        { "label": "2K", "unit": "image", "credits": 78, "usd": 0.078 },
        { "label": "4K", "unit": "image", "credits": 117, "usd": 0.117 }
      ],
      "input_schema": {
        "type": "object",
        "properties": {
          "prompt": { "type": "string", "minLength": 1, "maxLength": 20000 },
          "...": {}
        },
        "required": ["prompt"],
        "additionalProperties": false
      }
    }
  ]
}

GET /v1/models/{id} returns one model. It also answers for a model that is temporarily unavailable, with "available": false; creating a task for it returns 422 model_unavailable until it is back. An unknown ID returns 404 not_found.

pricing[].unit is image, video (flat price per clip) or second (multiply by duration).

Parameters by model#

Fields not listed are rejected. image_urls switches a model from text-to-image or text-to-video to image-to-image or image-to-video; for video models, pass 1 URL for the first frame or 2 for the first and last frame.

For gpt-image-2, some aspect ratios are not available at higher resolutions: at 2K, 5:4, 4:5, 3:1, 1:3 and 9:21 are rejected; at 4K, 3:1, 1:3 and 9:21 are rejected.