Models
Available image models, providers, and supported params
List models
GET /v1/models?type=imageReturns all enabled image models with their cost and accepted params. This is the canonical source of truth — use it to discover new models or validate param names.
curl -s https://api.goodtake.ai/v1/models?type=image \
-H "Authorization: Bearer $GOODTAKE_API_KEY" | jq .Current models
| Model identifier | Provider | Notes |
|---|---|---|
gpt-image-2 | fal (OpenAI) | Excellent text-in-image, editing via image_urls |
seedream-5-0-260128 | ByteDance | Latest Seedream, highest quality |
seedream-4-5-251128 | ByteDance | Proven quality, broad size support |
seedream-4-0-250828 | ByteDance | Legacy, use for backward compatibility |
gemini-3.1-flash-image-preview | Fast, grounding and thinking support | |
gemini-3-pro-image-preview | Pro-tier, multi-step reasoning |
Supported params per model
Pass model-specific options in the params object of your generate request. Unknown keys are rejected with a 400 and the list of supported keys.
gpt-image-2
| Param | Type | Description |
|---|---|---|
image_size | string | e.g. 1024x1024, 1792x1024 |
quality | string | low, medium, high, auto |
num_images | integer | 1–4 |
output_format | string | png, jpeg, webp |
mask_url | string | For inpainting edits; image_urls must also be set |
seedream-* (ByteDance)
| Param | Type | Description |
|---|---|---|
size | string | 1K, 2K, 4K, 2048x2048, 2560x1440, etc. |
number_of_images | integer | 1–4 |
optimize_prompt_mode | string | standard, creative, precise |
output_format | string | png, jpeg |
gemini-* (Google)
| Param | Type | Description |
|---|---|---|
aspect_ratio | string | e.g. 16:9, 1:1, 9:16 |
resolution | string | standard, high |
number_of_images | integer | 1–4 |
seed | integer | For reproducibility |
thinking_level | string | low, medium, high |
enable_thinking | boolean | Enables multi-step reasoning |
enable_grounding | boolean | Grounds generation on context |
enable_image_search | boolean | Uses image search context |
output_format | string | png, jpeg |
Reference images
Pass hosted http(s) or data: URIs in the top-level image_urls array to provide reference or edit images. For gpt-image-2, supplying image_urls routes the request to the edit endpoint automatically.
Internal/private addresses (e.g. localhost, RFC 1918 ranges) are rejected. Reference images must be publicly reachable.