Developer API

Ricochet Code API

Ricochet coding automation включает hosted model gateway, budget checks, usage reporting, premium approvals и Cloud Bridge для remote IDE control.

#Budget and usage

Проверяйте ricochet_code credits, отправляйте usage и запрашивайте premium approval decisions.

Метод	Endpoint	Авторизация	Область	Аудитория	Описание
GET	`/ricochet/budget`	API key	ricochet_code	Ricochet-клиенты	Проверяет ricochet_code credits, plan, window limits, task limits и upgrade URL перед hosted AI run.
POST	`/ricochet/usage/quote`	API key	ricochet_code	Ricochet-клиенты	Считает и резервирует hosted Ricochet usage перед upstream model call.Используйте перед upstream hosted-model вызовом.
POST	`/ricochet/usage/report`	API key	ricochet_code	Ricochet-клиенты	Отправляет hosted model usage с idempotency, token counts, provider, model и billing metadata.
GET	`/ricochet/usage`	API key	ricochet_code	Ricochet-клиенты	Показывает Ricochet hosted usage events с filters по session, run, provider, model и limit.
POST	`/ricochet/usage/approve-premium`	API key	ricochet_code	Ricochet-клиенты	Сохраняет temporary approval для premium model usage в task, run или session.
GET	`/ricochet/sessions`	User token	-	Ricochet-клиенты	Показывает Ricochet IDE и device sessions для current user.
DELETE	`/ricochet/sessions/:id`	User token	-	Ricochet-клиенты	Отзывает Ricochet IDE или device session.

GET/ricochet/budget

Проверяет ricochet_code credits, plan, window limits, task limits и upgrade URL перед hosted AI run.

Авторизация: API keyОбласть: ricochet_codeАудитория: Ricochet-клиенты

POST/ricochet/usage/quote

Считает и резервирует hosted Ricochet usage перед upstream model call.Используйте перед upstream hosted-model вызовом.

Авторизация: API keyОбласть: ricochet_codeАудитория: Ricochet-клиенты

POST/ricochet/usage/report

Отправляет hosted model usage с idempotency, token counts, provider, model и billing metadata.

Авторизация: API keyОбласть: ricochet_codeАудитория: Ricochet-клиенты

GET/ricochet/usage

Показывает Ricochet hosted usage events с filters по session, run, provider, model и limit.

Авторизация: API keyОбласть: ricochet_codeАудитория: Ricochet-клиенты

POST/ricochet/usage/approve-premium

Сохраняет temporary approval для premium model usage в task, run или session.

Авторизация: API keyОбласть: ricochet_codeАудитория: Ricochet-клиенты

GET/ricochet/sessions

Показывает Ricochet IDE и device sessions для current user.

Авторизация: User tokenОбласть: -Аудитория: Ricochet-клиенты

DELETE/ricochet/sessions/:id

Отзывает Ricochet IDE или device session.

Авторизация: User tokenОбласть: -Аудитория: Ricochet-клиенты

#Hosted model gateway

Используйте legacy Ricochet chat completions alias для существующих coding clients. Новый generic model access должен идти через AI Gateway.

Пример

curl "https://api.grik.io/api/v1/ricochet/budget?task_id=run_123" \
  -H "Authorization: Bearer GRIK_API_KEY"

curl -X POST https://api.grik.io/api/v1/ricochet/openai/v1/chat/completions \
  -H "Authorization: Bearer GRIK_API_KEY" \
  -H "Idempotency-Key: run_123_turn_1" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ricochet-code",
    "messages": [
      {"role": "user", "content": "Review this repository and suggest the first safe fix."}
    ],
    "stream": true
  }'

curl -X POST https://api.grik.io/api/v1/ricochet/openai/v1/responses \
  -H "Authorization: Bearer GRIK_API_KEY" \
  -H "Idempotency-Key: run_123_response_1" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ricochet-code",
    "input": "Review this repository and suggest the first safe fix.",
    "stream": true
  }'

Метод	Endpoint	Авторизация	Область	Аудитория	Описание
POST	`/ricochet/openai/v1/chat/completions`	API key	ricochet_code	Ricochet-клиенты	Legacy alias для Ricochet hosted coding chat completions. Для новых generic model integrations используйте /chat/completions в AI Gateway.Совместимый route для существующих Ricochet-клиентов.
POST	`/ricochet/openai/v1/responses`	API key	ricochet_code	Ricochet-клиенты	Ricochet hosted coding Responses API alias для клиентов, которые используют OpenAI Responses.Совместимый route для существующих Ricochet-клиентов.

POST/ricochet/openai/v1/chat/completions

Legacy alias для Ricochet hosted coding chat completions. Для новых generic model integrations используйте /chat/completions в AI Gateway.Совместимый route для существующих Ricochet-клиентов.

Авторизация: API keyОбласть: ricochet_codeАудитория: Ricochet-клиенты

POST/ricochet/openai/v1/responses

Ricochet hosted coding Responses API alias для клиентов, которые используют OpenAI Responses.Совместимый route для существующих Ricochet-клиентов.

Авторизация: API keyОбласть: ricochet_codeАудитория: Ricochet-клиенты