Один API. Модели под вашу задачу.

Создайте API-ключ в кабинете, сохраните его в переменной окружения и проверьте список доступных именно вашему ключу моделей. Не публикуйте ключ в клиентском JavaScript.

export AIMCODE_API_KEY="ваш_секретный_ключ"
curl https://www.aimcode.pro/v1/models \
  -H "Authorization: Bearer $AIMCODE_API_KEY"

$env:AIMCODE_API_KEY = "ваш_секретный_ключ"
curl.exe https://www.aimcode.pro/v1/models `
  -H "Authorization: Bearer $env:AIMCODE_API_KEY"

В примерах ниже используется gpt-5.6-sol как иллюстрация. Список моделей и доступность могут изменяться; фактический ID всегда берите из GET /v1/models.

Для публичных /v1/* передавайте ключ заголовком Authorization: Bearer <key> либо x-api-key: <key>. Ключ может иметь ограничения по моделям и лимиту использования. Creato использует отдельную HttpOnly-сессию браузера; API-ключ для его /api/playground не подходит.

• Не храните ключ в репозитории, браузере, URL или открытых логах.
• Создавайте отдельный ключ для каждого приложения и отключайте неиспользуемые.
• По 401 перепроверьте ключ; по 403 — доступ к модели для этого ключа.

GET /v1/models возвращает модели, разрешённые вашему ключу. Публичный GET /api/public/catalog удобен для ознакомления, но сам по себе не гарантирует доступ конкретного ключа или стабильность внешнего провайдера.

Поля input_modalities и output_modalities описывают модель; они не означают, что любой маршрут API принимает все форматы файла. Для конкретной операции используйте соответствующий endpoint.

Для привычного интерфейса сообщений используйте POST /v1/chat/completions. Для клиентов Responses доступен POST /v1/responses. Потоковый режим передаётся через "stream": true; ошибки внутри потока обрабатывайте как неуспешный результат даже при HTTP 200.

curl https://www.aimcode.pro/v1/chat/completions \
  -H "Authorization: Bearer $AIMCODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"Привет! Коротко объясни, как работает AIMCODE."}]}'

curl https://www.aimcode.pro/v1/responses \
  -H "Authorization: Bearer $AIMCODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","input":"Составь краткий план проекта."}'

Для клиентов, работающих с Messages, предусмотрены POST /v1/messages и POST /v1/messages/count_tokens. Формат входа зависит от выбранной модели; доступность проверьте через каталог.

curl https://www.aimcode.pro/v1/messages \
  -H "x-api-key: $AIMCODE_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":256,"messages":[{"role":"user","content":"Привет!"}]}'

Для создания — POST /v1/images/generations с текстовым промптом. Для редактирования — POST /v1/images/edits с изображением через multipart/form-data. Проверьте доступность модели перед повтором: внешний провайдер может временно её отключить.

curl https://www.aimcode.pro/v1/images/generations \
  -H "Authorization: Bearer $AIMCODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"Минималистичная обложка об AI-инструментах","n":1}'

curl https://www.aimcode.pro/v1/images/edits \
  -H "Authorization: Bearer $AIMCODE_API_KEY" \
  -F "model=gpt-image-2" \
  -F "prompt=Сделай фон вечерним" \
  -F "image=@./source.png"

В Creato «композиция» и «стиль» дополняют текст запроса, но не являются отдельными параметрами разрешения или гарантией соответствия промпту.

POST /v1/audio/transcriptions принимает файл через multipart. В Creato можно выбрать файл или записать его с микрофона; преобразование в текст зависит от доступности внешнего провайдера. Также существует маршрут /v1/audio/translations, но его поддержку конкретной моделью проверяйте отдельно.

curl https://www.aimcode.pro/v1/audio/transcriptions \
  -H "Authorization: Bearer $AIMCODE_API_KEY" \
  -F "model=gpt-4o-transcribe" \
  -F "file=@./recording.wav"

POST /v1/videos/generations направляет запрос поставщику. Для модели grok-imagine-video проверен текстовый промпт и короткий клип; генерация может вернуть асинхронный статус pending. После завершения Creato сохраняет результат на сервере и возвращает защищённую ссылку на просмотр и скачивание MP4.

curl https://www.aimcode.pro/v1/videos/generations \
  -H "Authorization: Bearer $AIMCODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-imagine-video","prompt":"Световые линии складываются в логотип","duration":4}'

Creato доступен после входа в кабинет: Спросить, Кампания, Изображение, Видео, Аудио. План ролика создаёт отдельный платный запрос на каждый кадр; результаты показываются по очереди, но сервер не склеивает клипы в один файл.

Для загрузки Creato отправляет один файл в attachment с name, type и dataUrl. У API есть предел размера JSON-тела 32 MiB, а сам интерфейс ограничивает изображение 8 MiB, аудио 20 MiB. Текст и изображения текущей сессии после обновления страницы не восстанавливаются: экспортируйте JSON до закрытия вкладки. Видео-задания восстанавливаются отдельно.

GET /v1/balance показывает доступные токены для текущего ключа и account_balance. Расход отражается в журнале запросов AIMCODE. Для успешного ответа приоритет у явно сообщённого поставщиком charged_tokens, включая значение 0; при его отсутствии может применяться оценка, помеченная как billingSource: estimate. Кэшированные токены видны отдельно, но фиксированной скидки на кэш без подтверждённого тарифа не обещаем.

curl https://www.aimcode.pro/v1/balance \
  -H "Authorization: Bearer $AIMCODE_API_KEY"

Ошибка провайдера внутри SSE — это не успешная генерация, даже если HTTP-соединение уже открыто. При спорном списании сохраните дату, модель, внутренний ID запроса и providerRequestId, если он вернулся: это помогает сверить операцию с провайдером.