1. Зарегистрируйся

createya.ai → email или Telegram. На старте начисляется 100 кредитов бесплатно.

2. Получи API-ключ

createya.ai/settings/api-keys → Create new key.

Формат ключа: crya_sk_live_<32hex>. Показывается один раз — сохрани в свой secret manager.

export CREATEYA_API_KEY="crya_sk_live_abc123..."

3. Выбери путь

🤖 Если ты строишь AI-агента → MCP

Подключи https://api.createya.ai/mcp к Claude, Cursor, Cline, Windsurf или Codex. Подробные инструкции для каждого клиента — в разделе MCP Integration.

💻 Если ты пишешь свой код → REST

curl -X POST https://api.createya.ai/v1/run \
  -H "Authorization: Bearer $CREATEYA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "input": {
      "prompt": "кот на луне в стиле Studio Ghibli",
      "aspect_ratio": "16:9"
    }
  }'

Ответ:

{
  "run_id": "run_01HZX...",
  "status": "completed",
  "output": {
    "urls": ["https://cdn-new.createya.ai/image/.../abc123.png"]
  }
}

4. Async-задачи (видео и музыка)

Видео-модели возвращают 202 Accepted с run_id. Опрашивай статус каждые 10 секунд:

curl https://api.createya.ai/v1/runs/$RUN_ID \
  -H "Authorization: Bearer $CREATEYA_API_KEY"

Когда статус становится completed — output.url содержит готовое видео.

Что дальше

• Авторизация — детали про ключи и rate limits
• REST API Reference — полная спецификация
• Каталог моделей — что можно генерить
• MCP Integration — для AI-агентов