Отправка API-запроса GetAPI.ONE

Предварительные условия и границы

• Ключ GetAPI.ONE с ограниченными правами, сохранённый в GETAPI_ONE_API_KEY.
• Текущая модель каталога, которая явно поддерживает нужный тип конечной точки.
• Командная строка с установленным curl и разрешённым исходящим HTTPS-доступом к www.getapi.one.
• Согласие с тем, что реальный запрос может повлечь оплату использования. Примеры были проверены без отправки запросов к модели.

• Создайте и загрузите ключ
• Выберите модель, совместимую с конечной точкой

1. Выберите заявленную конечную точку

Другие семейства протоколов используют иные пути и тела запросов. Следуйте конечной точке на странице выбранной модели; не приводите вызовы Anthropic, Gemini, изображений или видео к двум приведённым выше примерам.

2. Пример Responses API

Используйте этот пример только после выбора модели каталога, которая поддерживает конечную точку Responses. Перед запуском замените YOUR_RESPONSES_MODEL.

curl --fail-with-body https://www.getapi.one/v1/responses \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_RESPONSES_MODEL",
    "input": "Reply with the word ready."
  }'

3. Пример Chat Completions

Используйте этот пример только тогда, когда выбранная модель каталога поддерживает конечную точку OpenAI Chat. Перед запуском замените YOUR_CHAT_MODEL.

curl --fail-with-body https://www.getapi.one/v1/chat/completions \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CHAT_MODEL",
    "messages": [
      {"role": "user", "content": "Reply with the word ready."}
    ]
  }'

4. Проверьте результат

1. Сначала прочитайте статус HTTP. Статус 2xx означает, что шлюз принял и завершил HTTP-запрос, но клиент всё равно должен проверить объект ответа на наличие ожидаемого результата.
2. Для Responses проверяйте состояние и структуру output возвращённого ответа. Для Chat Completions проверяйте структуру choices. Не предполагайте одинаковый формат ответа для разных протоколов.
3. Откройте журнал запросов или использования GetAPI.ONE и сопоставьте время, конечную точку, модель и идентификатор запроса, если он доступен.

Потоковая передача и повторы

Потоковая передача изменяет транспорт ответа и обработку событий; поддержка зависит от выбранной конечной точки и модели. Начните с непотокового запроса, а перед добавлением потоковых параметров изучите справочник протокола и страницу модели.

• Не повторяйте автоматически запросы с ошибками аутентификации, квоты, разрешений или выбора модели.
• Прежде чем повторять запрос после тайм-аута или сбоя вышестоящего сервиса, определите, мог ли исходный запрос быть обработан и безопасно ли повторять операцию.
• В приложениях ограничивайте число повторов и используйте задержку; сохраняйте идентификаторы и временные метки запросов для диагностики.

Ветви ошибок

• Контрольный список устранения неполадок
• Подготовьте обращение в поддержку