Документация

Минимальный пример запроса

curl --request POST \
  --url https://ai.wormsoft.ru/api/gpt/v1/messages \
  --header 'x-api-key: ***' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wormsoft/code/medium",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Привет" }
    ]
  }'

Ключ можно передавать и через заголовок Authorization: Bearer YOUR_API_KEY.

Системный промпт

Инструкция для модели передаётся отдельным полем system, а не отдельным сообщением в messages.

{
  "model": "wormsoft/code/medium",
  "max_tokens": 1024,
  "system": "Ты — краткий ассистент.",
  "messages": [
    { "role": "user", "content": "Привет" }
  ]
}

Вызов инструментов

Для сценариев с агентами передавайте tools в формате Anthropic.

{
  "model": "wormsoft/code/medium",
  "max_tokens": 1024,
  "messages": [
    { "role": "user", "content": "Какая погода в Москве?" }
  ],
  "tools": [
    {
      "name": "get_weather",
      "description": "Get current weather",
      "input_schema": {
        "type": "object",
        "properties": {
          "city": { "type": "string" }
        }
      }
    }
  ]
}

Пример ответа

{
  "id": "msg_1a2b3c",
  "type": "message",
  "role": "assistant",
  "content": [
    { "type": "text", "text": "Привет! Чем помочь?" }
  ],
  "model": "wormsoft/code/medium",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 12,
    "output_tokens": 8
  }
}

Ответ с вызовом инструмента

{
  "id": "msg_4d5e6f",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "tool_use",
      "id": "call_1",
      "name": "get_weather",
      "input": { "city": "Москва" }
    }
  ],
  "model": "wormsoft/code/medium",
  "stop_reason": "tool_use",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 20,
    "output_tokens": 15
  }
}

Ошибки и лимиты