Developer API

Быстрый старт

Один раз пройдите auth, создайте developer API key, затем вызывайте https://api.grik.io/api/v1 через Authorization: Bearer GRIK_API_KEY.

#Вход через device code

01
Создайте device code для app, Ricochet client или editor extension.
02
Откройте verification URL и подтвердите показанный user code.
03
Опрашивайте token endpoint, затем создайте scoped API key.
04
Передавайте Authorization: Bearer GRIK_API_KEY в server-side API requests.

#Создать API key

Создавайте scoped server-side keys из authenticated Grik account. Raw key показывается только один раз.

Пример

curl -X POST https://api.grik.io/api/v1/auth/device/code \
  -H "Content-Type: application/json" \
  -d '{
    "client": "ricochet-vscode",
    "scope": "ricochet_code"
  }'

# Approve the user_code in the browser, then poll:
curl -X POST https://api.grik.io/api/v1/auth/device/token \
  -H "Content-Type: application/json" \
  -d '{"device_code": "DEVICE_CODE"}'

curl https://api.grik.io/api/v1/users/me \
  -H "Authorization: Bearer ACCESS_TOKEN"

curl -X POST https://api.grik.io/api/v1/auth/api-keys \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production API",
    "scopes": ["video", "rico.media", "ricochet_code", "ai.gateway", "social"],
    "mode": "live"
  }'

#Первый запрос

Передавайте API key как bearer token и добавляйте Idempotency-Key только на create-style requests, где он реализован.

Пример

curl -X POST https://api.grik.io/api/v1/generate/video \
  -H "Authorization: Bearer GRIK_API_KEY" \
  -H "Idempotency-Key: video_job_123" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling",
    "task_type": "multi-image2video",
    "prompt": "A cinematic product reveal on a black reflective table",
    "aspect_ratio": "16:9",
    "duration": "5s",
    "mode": "standard",
    "sound": "on",
    "image_list": [
      {"image": "BASE64_IMAGE_1"},
      {"image": "BASE64_IMAGE_2"}
    ]
  }'