Qwen Character API

Полный справочник API для моделей ролевого общения Qwen Character от Alibaba. Модели Qwen Character используют эндпоинт chat completions Flaq AI, но также поддерживают поля, специфичные для персонажей: долгосрочную память, симуляцию группового чата и частичное продолжение assistant.

Варианты модели

Этот API поддерживает два варианта модели:

Краткое сравнение

Как работает ролевая игра с персонажем

Для ролевого общения с одним персонажем используйте обычные сообщения system, user и assistant. Стабильные инструкции персонажа для текущего запроса помещайте в сообщение system. Когда долгосрочная память включена, помещайте повторно используемый профиль персонажа в profile.

Для симуляции группового чата Qwen Character не выводит имена говорящих автоматически из profile. Вызывающая сторона должна вручную писать имя говорящего в начале content каждого сообщения, например Cheng Yi: или Ling Lu:. Чтобы модель продолжила от лица конкретного персонажа, добавьте финальное сообщение assistant, где content является префиксом целевого говорящего, и установите partial: true.

partial — это поле уровня сообщения в финальном сообщении assistant. Это не параметр запроса верхнего уровня.

Qwen Plus Character

Эндпоинт {#}

httpКопировать
POST /api/v1/chat/completions

Параметры запроса

Обязательные

Заголовки

Поддержка сообщений

Поля сообщений

Необязательные

Когда долгосрочная память включена, необходимо предоставить:

• Заголовок запроса x-session
• profile в теле запроса
• enable_long_term_memory: true

skip_save_types поддерживает следующие значения:

Базовый запрос ролевой игры

javascriptКопировать
const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'qwen-plus-character',
    stream: false,
    max_tokens: 1200,
    temperature: 0.8,
    messages: [
      {
        role: 'system',
        content: 'You are Jiang Rang, a witty high-school Go prodigy. Stay playful, warm, and concise.'
      },
      {
        role: 'user',
        content: 'Why are you reading Go records outside the milk tea shop again?'
      }
    ]
  })
});

Запрос с долгосрочной памятью

javascriptКопировать
const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'text/event-stream',
    'Content-Type': 'application/json',
    'x-session': 'your-session-id'
  },
  body: JSON.stringify({
    model: 'qwen-plus-character',
    messages: [
      {
        role: 'system',
        content: 'You are a witty high-school student who speaks with humor and warmth.'
      },
      {
        role: 'user',
        content: 'Remember that I prefer lightly sweet milk tea.'
      }
    ],
    stream: true,
    max_tokens: 1200,
    temperature: 0.8,
    seed: 12345,
    profile: 'You are a witty high-school student who remembers user preferences and stays in character.',
    enable_long_term_memory: true,
    memory_entries: 50,
    skip_save_types: []
  })
});

Симуляция группового чата с partial

Симуляция группового чата реализуется через текст сообщений. API не назначает и не переносит имена говорящих автоматически. Вручную пишите имя каждого говорящего в начале content, затем добавьте финальное сообщение assistant с префиксом целевого говорящего и partial: true.

javascriptКопировать
const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'qwen-plus-character',
    stream: false,
    max_tokens: 800,
    temperature: 0.8,
    messages: [
      {
        role: 'system',
        content: 'In a musician group chat, Ling Lu is a 25-year-old gifted musician known for sharp humor and a regional accent. Cheng Yi is his music partner, Tao Le is his partner, and Ma Hui is a friend. Keep Ling Lu sarcastic but caring. Reply in one short message.'
      },
      {
        role: 'user',
        content: 'Cheng Yi: Are you free this weekend? I want feedback on the new song.'
      },
      {
        role: 'user',
        content: 'Tao Le: He is right, but do not stay up too late editing.'
      },
      {
        role: 'user',
        content: 'Ma Hui: Let us grab dinner and talk. My treat.'
      },
      {
        role: 'assistant',
        content: 'Ling Lu:',
        partial: true
      }
    ]
  })
});

Продолжить от лица персонажа с partial

Используйте тот же шаблон partial, когда пользователь не ответил, но вы хотите, чтобы персонаж продолжил говорить. Добавьте финальное сообщение assistant с префиксом персонажа.

javascriptКопировать
{
  model: 'qwen-plus-character',
  stream: false,
  messages: [
    {
      role: 'system',
      content: 'You are Jiang Rang, a high-school Go prodigy. Speak with humor and warmth.'
    },
    {
      role: 'assistant',
      content: 'Class monitor, what are you doing?'
    },
    {
      role: 'assistant',
      content: '(He waves at you.) Did being class monitor make you forget how to answer me?'
    },
    {
      role: 'assistant',
      content: 'Jiang Rang:',
      partial: true
    }
  ]
}

Qwen Flash Character

Параметры запроса

Тот же протокол, что и у Qwen Plus Character, со следующими отличиями:

Пример запроса

javascriptКопировать
{
  model: 'qwen-flash-character',
  messages: [
    {
      role: 'system',
      content: 'You are a calm library assistant who speaks briefly and vividly.'
    },
    {
      role: 'user',
      content: 'Introduce yourself in three sentences.'
    }
  ],
  stream: true,
  max_tokens: 800,
  temperature: 0.7,
  seed: 12345
}

Формат ответа

Модели Qwen Character LLM возвращают ответы completion, совместимые с OpenAI. При stream: true ответ передаётся в формате Server-Sent Events; при stream: false ответ представляет собой один JSON-объект.

Лучшие практики

• Помещайте инструкции персонажа уровня запроса в сообщения system.
• Помещайте повторно используемый фон персонажа в profile только когда долгосрочная память включена.
• Повторно используйте одно и то же значение x-session в связанных разговорах, когда долгосрочная память включена. Сессии, не использованные в течение 365 дней, могут быть очищены.
• Продолжайте отправлять недавние сообщения разговора, когда это полезно; долгосрочная память и краткосрочный контекст могут работать вместе.
• Для симуляции группового чата вручную пишите имена говорящих в content. API не будет выводить имена из profile.
• Используйте partial: true только в финальном сообщении assistant, когда модель должна продолжить с префикса.
• Используйте Qwen Flash Character для легкого ролевого общения и Qwen Plus Character для более богатого качества диалога.