Перейти к основному содержанию
POST
/
v1
/
chat
/
completions
curl --request POST \
  --url https://api.apimart.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o", # Can be replaced with any supported model ID
    "messages": [
      {
        "role": "system",
        "content": "You are a professional AI assistant."
      },
      {
        "role": "user",
        "content": "Tell me about the history of artificial intelligence."
      }
    ]
  }'
{
  "code": 200,
  "data": {
    "id": "chatcmpl-9876543210",
    "object": "chat.completion",
    "created": 1677652288,
    "model": "gpt-4o",
    "choices": [
      {
        "index": 0,
        "message": {
          "role": "assistant",
          "content": "The history of artificial intelligence (AI) dates back to the 1950s...\n\n1. **Early Period (1950s-1960s)**: The proposal of the Turing Test marked the beginning of AI research...\n\n2. **Expert Systems Era (1970s-1980s)**: Rule-based systems began to be applied in medical diagnosis, financial analysis, and other fields...\n\n3. **Rise of Machine Learning (1990s-2000s)**: Statistical learning methods gradually became mainstream...\n\n4. **Deep Learning Revolution (2010s-Present)**: Breakthroughs in neural network technology brought explosive growth to AI..."
        },
        "finish_reason": "stop"
      }
    ],
    "usage": {
      "prompt_tokens": 28,
      "completion_tokens": 320,
      "total_tokens": 348
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o", # Can be replaced with any supported model ID
    "messages": [
      {
        "role": "system",
        "content": "You are a professional AI assistant."
      },
      {
        "role": "user",
        "content": "Tell me about the history of artificial intelligence."
      }
    ]
  }'
{
  "code": 200,
  "data": {
    "id": "chatcmpl-9876543210",
    "object": "chat.completion",
    "created": 1677652288,
    "model": "gpt-4o",
    "choices": [
      {
        "index": 0,
        "message": {
          "role": "assistant",
          "content": "The history of artificial intelligence (AI) dates back to the 1950s...\n\n1. **Early Period (1950s-1960s)**: The proposal of the Turing Test marked the beginning of AI research...\n\n2. **Expert Systems Era (1970s-1980s)**: Rule-based systems began to be applied in medical diagnosis, financial analysis, and other fields...\n\n3. **Rise of Machine Learning (1990s-2000s)**: Statistical learning methods gradually became mainstream...\n\n4. **Deep Learning Revolution (2010s-Present)**: Breakthroughs in neural network technology brought explosive growth to AI..."
        },
        "finish_reason": "stop"
      }
    ],
    "usage": {
      "prompt_tokens": 28,
      "completion_tokens": 320,
      "total_tokens": 348
    }
  }
}

Авторизация

Authorization
string
обязательно
Все конечные точки API требуют аутентификации Bearer TokenПолучите свой API-ключ:Откройте страницу управления API-ключами, чтобы получить ваш API-ключДобавьте его в заголовок запроса:
Authorization: Bearer YOUR_API_KEY

Body

model
string
по умолчанию:"gpt-5"
обязательно
Название моделиПоддерживаемые модели:
  • OpenAI: gpt-5, gpt-5-chat-latest, gpt-5-mini, gpt-5-nano, gpt-5-pro
  • Anthropic: claude-sonnet-4-5-20250929, claude-opus-4-1-20250805, claude-haiku-4-5-20251001, claude-opus-4-1-20250805-thinking, claude-sonnet-4-5-20250929-thinking
  • Google: gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-pro-thinking, gemini-2.5-flash-lite
  • DeepSeek: deepseek-v3.1-250821, deepseek-v3.1-think-250821, deepseek-v3-0324
  • Doubao: doubao-seed-1-6-251015, doubao-seed-1-6-flash-250828, doubao-seed-1-6-thinking-250715
  • Список моделей постоянно пополняется…
messages
array
обязательно
Список сообщений беседыМассив сообщений. Каждое сообщение содержит поля role и content.💡 Быстрое заполнение (область «Try it»):
  1. Нажмите «+ Add an item», чтобы добавить сообщение
  2. Введите user (сообщение пользователя), assistant (ответ AI) или system (системная подсказка) в поле role
  3. В поле content введите то, что хотите сказать
Пример:
[{"role": "user", "content": "Hello, please introduce yourself"}]
Расширенное использование:Добавление системной подсказки (для определения поведения AI):
[
  {"role": "system", "content": "You are a professional Python tutor"},
  {"role": "user", "content": "How do I learn programming?"}
]
Многошаговый диалог (с контекстом):
[
  {"role": "user", "content": "Hello"},
  {"role": "assistant", "content": "Hi! How can I help you?"},
  {"role": "user", "content": "Tell me about AI"}
]
Описание ролей:
  • user: сообщение пользователя (используется в большинстве случаев)
  • system: системная подсказка для задания поведения и роли AI
  • assistant: предыдущие ответы AI, используются для контекста разговора
temperature
number
Управляет случайностью вывода, диапазон 0–2
  • Меньшие значения (например, 0.2) делают вывод более детерминированным
  • Большие значения (например, 1.8) делают вывод более случайным
По умолчанию: 1.0
max_tokens
integer
Максимальное количество токенов для генерацииУ разных моделей разные максимальные лимиты, обратитесь к документации конкретной модели
stream
boolean
Использовать ли потоковый вывод
  • true: потоковый ответ (формат SSE)
  • false: полный ответ за один раз
По умолчанию: true
top_p
number
Параметр ядровой выборки (nucleus sampling), диапазон 0–1Управляет разнообразием генерируемого текста, рекомендуется использовать либо этот параметр, либо temperatureПо умолчанию: 1.0
frequency_penalty
number
Штраф за частоту, диапазон от -2.0 до 2.0Положительные значения уменьшают вероятность повторения одних и тех же словПо умолчанию: 0
presence_penalty
number
Штраф за присутствие, диапазон от -2.0 до 2.0Положительные значения увеличивают вероятность обсуждения новых темПо умолчанию: 0
stop
string or array
Стоп-последовательностиДо 4 последовательностей, при встрече которых генерация останавливается
n
integer
Количество вариантов ответа для генерацииПо умолчанию: 1⚠️ Внимание: Необходимо ввести обычное число (например, 1), без кавычек, иначе возникнет ошибка

Response

id
string
Уникальный идентификатор ответа
object
string
Тип объекта, фиксированное значение chat.completion
created
integer
Временная метка создания
model
string
Фактически использованное название модели
choices
array
Список сгенерированных ответов
usage
object
Статистика использования токенов

Поддерживаемые модели

Серия OpenAI

  • gpt-5 — базовая модель GPT-5
  • gpt-5-chat-latest — последняя чат-версия GPT-5
  • gpt-5-mini — облегчённая версия GPT-5 с оптимальной стоимостью
  • gpt-5-nano — сверхлёгкая версия GPT-5
  • gpt-5-pro — профессиональная улучшенная версия GPT-5

Серия Anthropic

  • claude-haiku-4-5-20251001 — Claude 4.5, версия с быстрым откликом
  • claude-sonnet-4-5-20250929 — Claude 4.5, сбалансированная версия
  • claude-opus-4-1-20250805 — самая мощная флагманская модель Claude 4.1
  • claude-opus-4-1-20250805-thinking — Claude 4.1 Opus, версия с глубоким мышлением
  • claude-sonnet-4-5-20250929-thinking — Claude 4.5 Sonnet, версия с глубоким мышлением

Серия Google

  • gemini-2.5-flash — Gemini 2.5, быстрая версия
  • gemini-2.5-pro — Gemini 2.5, профессиональная версия
  • gemini-2.5-flash-lite — Gemini 2.5, сверхлёгкая версия
  • gemini-2.5-pro-thinking — Gemini 2.5 Pro, версия с глубоким мышлением

Серия DeepSeek

  • deepseek-v3.1-250821 — DeepSeek V3.1, базовая версия
  • deepseek-v3.1-think-250821 — DeepSeek V3.1, версия с мышлением
  • deepseek-v3-0324 — DeepSeek V3, стандартная версия

Серия Doubao

  • doubao-seed-1-6-flash-250828 — Doubao Seed 1.6, быстрая версия
  • doubao-seed-1-6-thinking-250715 — Doubao Seed 1.6, версия с мышлением
  • doubao-seed-1-6-251015 — Doubao Seed 1.6, стандартная версия

Примеры использования

Базовый диалог

{
  "model": "gpt-4o",
  "messages": [
    {"role": "user", "content": "Hello"}
  ]
}

Системная подсказка

{
  "model": "claude-3-5-sonnet",
  "messages": [
    {"role": "system", "content": "You are a professional Python programming tutor"},
    {"role": "user", "content": "How to use list comprehensions?"}
  ]
}

Многошаговый диалог

{
  "model": "gemini-2.0-flash",
  "messages": [
    {"role": "user", "content": "What is machine learning?"},
    {"role": "assistant", "content": "Machine learning is a branch of artificial intelligence..."},
    {"role": "user", "content": "Can you give me an example?"}
  ]
}

Потоковый вывод

{
  "model": "gpt-4o",
  "messages": [
    {"role": "user", "content": "Write a poem about spring"}
  ],
  "stream": true
}