# Createya Public API

> Universal pass-through API for AI image/video/audio/text generation.
> Contract: POST /v1/run { model, input } — input fields match the model's parameters_schema.

## Base URL
https://api.createya.ai

## Authentication
Authorization: Bearer crya_sk_<32hex>

## Endpoints
- GET  /v1/balance              — credits balance: { object:"balance", credits_balance:N }
- GET  /v1/models               — list models with parameters_schema and pricing
- POST /v1/run                  — run a model
- GET  /v1/runs/{id}            — poll async run status and result
- POST /v1/uploads              — inline multipart upload (<=25 MB), returns CDN url
- POST /v1/uploads/presigned    — presigned PUT URL for direct S3 upload (<=50 MB)
- POST /mcp                     — MCP JSON-RPC 2.0 (tools: list_models, run_model, get_run_status, get_balance, get_model_guide, request_upload_url)

## Prompt parameter
Каждая модель имеет prompt_mode ("required" | "optional" | null). Если set,
gateway инжектит параметр "prompt: string" в начало parameters_schema.
Текст промта идёт в input.prompt.

## Media inputs (image/video/audio)
В input.image_url / input.video_url / etc можно передавать:
- Любой публичный URL (https://...) — провайдер качает сам.
- CDN URL после загрузки через /v1/uploads (multipart) или /v1/uploads/presigned (PUT).
Inline base64 НЕ поддерживается.

## Available models
### `grok-imagine-i2i`
- Type: image, async
- Prompt: required
- Pricing: × num_images (1–4)

### `seedream-v4.5-i2i`
- Type: image, async
- Prompt: required
- Pricing: × num_images (1–6)

### `kling-video-v3-pro-i2v`
- Type: video, async
- Prompt: required
- Pricing: 17кр/сек · 3–15 сек

### `veo-3.1-t2v`
- Type: video, async
- Prompt: required
- Pricing: duration: 4s=120кр, 6s=180кр, 7s=210кр, 8s=240кр; resolution: 720p=240кр, 1080p=240кр, 4k=480кр

### `nano-banana-pro-t2i`
- Type: image, async
- Prompt: required
- Pricing: resolution: 1K=23кр, 2K=23кр, 4K=46кр; × num_images (1–4); +3кр с enable_web_search

### `kling-video-o3-std-r2v`
- Type: video, async
- Prompt: optional
- Pricing: 13кр/сек · 3–15 сек

### `nano-banana-pro-i2i`
- Type: image, async
- Prompt: required
- Pricing: resolution: 1K=23кр, 2K=23кр, 4K=46кр; × num_images (1–4); +3кр с enable_web_search

### `kling-video-o3-pro-i2v`
- Type: video, async
- Prompt: required
- Pricing: 17кр/сек · 3–15 сек

### `kling-video-v3-pro-t2v`
- Type: video, async
- Prompt: required
- Pricing: 17кр/сек · 3–15 сек

### `bytedance-seedance-2-fast`
- Type: video, async
- Prompt: required
- Pricing: resolution: 480p=94кр, 720p=200кр; 25кр/сек · 1–15 сек

### `flux-2-pro-i2i`
- Type: image, async
- Prompt: required
- Pricing: × num_images (1–4); +3кр с input_megapixels; +3кр с output_extra_megapixels

### `flux-kontext-pro-i2i`
- Type: image, async
- Prompt: required
- Pricing: × num_images (1–4)

### `kling-video-o3-pro-t2v`
- Type: video, async
- Prompt: required
- Pricing: 17кр/сек · 3–15 сек

### `bytedance-seedance-2`
- Type: video, async
- Prompt: required
- Pricing: resolution: 480p=115кр, 720p=248кр, 1080p=617кр, 4k=1259кр; 31кр/сек · 1–15 сек

### `recraft-v3-i2i`
- Type: image, async
- Prompt: required
- Pricing: style: 6–12кр (85 вариантов)

### `ideogram-v3-t2i`
- Type: image, async
- Prompt: required
- Pricing: rendering_speed: TURBO=5кр, BALANCED=10кр, QUALITY=15кр; × num_images (1–8)

### `nano-banana-2`
- Type: image, async
- Prompt: required
- Pricing: resolution: 1K=6кр, 2K=9кр, 4K=14кр

### `kling-video-v3-std-mc`
- Type: video, async
- Prompt: required
- Pricing: 19кр/input_video_duration_seconds · 1–15 input_video_duration_seconds

### `kling-video-o3-std-i2v`
- Type: video, async
- Prompt: optional
- Pricing: 13кр/сек · 3–15 сек

### `kling-video-o3-pro-v2v-r`
- Type: video, async
- Prompt: required
- Pricing: 26кр/сек · 3–15 сек

### `flux-2-pro-t2i`
- Type: image, async
- Prompt: required
- Pricing: × num_images (1–4); +3кр с output_extra_megapixels

### `kling-image-o3-i2i`
- Type: image, async
- Prompt: required
- Pricing: resolution: 1K=5кр, 2K=5кр, 4K=10кр; × num_images (1–9)

### `kling-image-o3-t2i`
- Type: image, async
- Prompt: required
- Pricing: resolution: 1K=5кр, 2K=5кр, 4K=10кр; × num_images (1–9)

### `kling-video-o3-pro-v2v`
- Type: video, async
- Prompt: required
- Pricing: 26кр/input_video_duration_seconds · 1–15 input_video_duration_seconds

### `sora-2-i2v`
- Type: video, async
- Prompt: required
- Pricing: 15кр/сек · 4–12 сек

### `seedream-v4.5-t2i`
- Type: image, async
- Prompt: required
- Pricing: × num_images (1–6)

### `seedream-v5-lite-t2i`
- Type: image, async
- Prompt: required
- Pricing: × num_images (1–6)

### `kling-video-o3-std-t2v`
- Type: video, async
- Prompt: optional
- Pricing: 13кр/сек · 3–15 сек

### `kling-video-v3-pro-mc`
- Type: video, async
- Prompt: required
- Pricing: 26кр/input_video_duration_seconds · 1–15 input_video_duration_seconds

### `kling-video-o3-pro-r2v`
- Type: video, async
- Prompt: required
- Pricing: 17кр/сек · 3–15 сек

### `higgsfield-soul-i2i`
- Type: image, async
- Prompt: optional
- Pricing: quality: medium=15кр, high=30кр

### `gpt-image2-t2i`
- Type: image, async
- Prompt: optional
- Pricing: resolution: 1K=5кр, 2K=9кр, 4K=14кр

### `gpt-image2-i2i`
- Type: image, async
- Prompt: optional
- Pricing: resolution: 1K=5кр, 2K=9кр, 4K=14кр

### `sora-2-t2v`
- Type: video, async
- Prompt: required
- Pricing: 15кр/сек · 4–12 сек

### `flux-kontext-pro-t2i`
- Type: image, async
- Prompt: required
- Pricing: × num_images (1–4)

### `grok-imagine-t2i`
- Type: image, async
- Prompt: required
- Pricing: × num_images (1–4)

### `imagen-4-ultra-t2i`
- Type: image, async
- Prompt: required
- Pricing: × num_images (1–4)

### `recraft-v3-t2i`
- Type: image, async
- Prompt: required
- Pricing: style: 6–12кр (83 вариантов)

### `seedream-v5-lite-i2i`
- Type: image, async
- Prompt: required
- Pricing: × num_images (1–6)

### `hailuo-2.3-pro-i2v`
- Type: video, async
- Prompt: required
- Pricing: 74 кредитов за запрос

### `kling-video-o3-std-v2v-r`
- Type: video, async
- Prompt: optional
- Pricing: 19кр/сек · 3–15 сек

### `kling-video-o3-std-v2v`
- Type: video, async
- Prompt: optional
- Pricing: 19кр/input_video_duration_seconds · 1–15 input_video_duration_seconds

### `seedance-v1.5-pro-t2v`
- Type: video, async
- Prompt: required
- Pricing: resolution: 480p=9кр, 720p=20кр, 1080p=45кр; 4кр/сек · 4–12 сек

### `seedance-v1.5-pro-i2v`
- Type: video, async
- Prompt: required
- Pricing: resolution: 480p=9кр, 720p=20кр, 1080p=45кр; 4кр/сек · 4–12 сек

### `veo-3.1-fast-t2v`
- Type: video, async
- Prompt: required
- Pricing: resolution: 720p=120кр, 1080p=120кр, 4k=360кр; duration: 4s=60кр, 6s=90кр, 7s=105кр, 8s=120кр

### `midjourney-t2i`
- Type: image, async
- Prompt: required
- Pricing: 15 кредитов за запрос

### `runway-gen4-t2i`
- Type: image, async
- Prompt: required
- Pricing: resolution: 720p=9кр, 1080p=15кр