Saltar al contenido

Crear una completion de chat

Chat Completions compatible con OpenAI: GPT, Gemini, GLM, Qwen, DeepSeek, Grok, Claude y otros modelos de chat comparten este endpoint.

POST/v1/chat/completions

Recibe una lista de mensajes de conversación y devuelve la respuesta del modelo. Con el SDK de OpenAI solo cambie el Base URL a https://api.hop-base.com/v1 y use la clave del grupo correspondiente.

La tabla solo incluye los campos que el gateway comprueba, reescribe o rechaza, y los valores indicados en cada página de modelo; los demás campos de OpenAI se reenvían sin cambios y sus rangos siguen la especificación oficial del modelo. El cuerpo completo de la solicitud admite hasta 60 MB; si lo supera, devuelve 413.

Los modelos Claude también pueden usar este endpoint con una clave de un grupo Claude; la facturación es idéntica a la de /v1/messages. Si se omite max_tokens, el valor predeterminado es 16000 sin streaming y 64000 con streaming, sin superar el límite de salida del modelo. Los modelos Claude no usan temperature / top_p; si se envían, se ignoran sin error. n mayor que 1, los campos heredados functions / function_call y la entrada de audio devuelven 400. Los bloques de razonamiento no se conservan entre turnos de llamadas a herramientas; si su cliente admite el protocolo de Anthropic, prefiera /v1/messages. /v1/responses no admite modelos Claude y devuelve 404.

Las respuestas sin streaming que generan un cargo devuelven el cargo real de la solicitud: los encabezados X-HopBase-Cost / X-HopBase-Cost-USD / X-HopBase-Currency y cost / cost_usd / currency en el objeto usage de nivel superior del cuerpo (los campos existentes de usage se conservan). cost_usd es el importe en USD realmente descontado del saldo; cost es el mismo cargo en CNY, y currency es siempre CNY. Las respuestas en streaming (SSE) no lo incluyen; consulta Uso en la consola. Las respuestas sin cargo, como los errores, no incluyen ninguno. Consulte API de cuenta · Cargos.

Encabezados

Authorization:obligatoriostring

Bearer sk-…: una clave de API creada en la consola; su grupo debe incluir el modelo solicitado

Parámetros del cuerpoJSON

Modelo
Los campos no listados se reenvían sin cambios. Elija una familia de modelos para ver los valores y límites que indica su documentación.
model:obligatoriostring

Un ID de modelo del grupo de la clave actual, según lo que devuelve GET /v1/models. Si el grupo no incluye el modelo, devuelve 404 model_not_found; los modelos de imagen como gpt-image-* devuelven 400 image models do not support Chat Completions, please use the Images API en este endpoint

messages:obligatorioarray of object

Mensajes de la conversación. Si falta devuelve 400 missing messages field; un array vacío devuelve 400 messages must not be an empty array

Elementos≥ 1

max_tokens:opcionalinteger

Límite de salida. El gateway no lo recorta ni lo reescribe; el máximo sigue la especificación oficial del modelo y, si se supera, el modelo devuelve un error

max_completion_tokens:opcionalinteger

Igual que max_tokens; nombre de campo más reciente de OpenAI

stream:opcionalboolean

true devuelve SSE; formato de eventos en Eventos de streaming

Predeterminadofalse

stream_options:opcionalobject

Opciones de streaming

tools:opcionalarray of object

Herramientas de función en formato de function tools de OpenAI; se reenvían sin cambios.

tool_choice:opcionalstring o object

auto / none / required o una función concreta; se reenvía sin cambios

temperature:opcionalnumber

Temperatura de muestreo; se reenvía sin cambios, con el rango de la especificación oficial del modelo

top_p:opcionalnumber

Muestreo de núcleo; se reenvía sin cambios, con el rango de la especificación oficial del modelo

reasoning_effort:opcionalstring

Nivel de razonamiento. Los valores varían según el modelo; elija la familia de modelos arriba para verlos

service_tier:opcionalstring

Solo se conservan priority / flex; los demás valores se eliminan antes de reenviar, sin error. priority solo se aplica en los grupos que lo admiten y se factura a precio Fast; en los demás, la solicitud se procesa en el nivel estándar a precio estándar. El grupo "GPT oficial directo (Azure)" no admite priority

Valorespriorityflex

Respuesta

200Éxito. Sin streaming es un JSON chat.completion; con stream: true es SSE (text/event-stream)

Encabezados de respuesta

X-HopBase-Cost:opcionalstring

Cargo de esta solicitud en CNY (el mismo cargo que X-HopBase-Cost-USD), con hasta 6 decimales, por ejemplo 0.0816. Solo se envía cuando la solicitud genera un cargo; no se envía en respuestas en streaming (SSE). Si la generación de imágenes tarda más de unos 40 segundos, los encabezados ya se enviaron: lee usage.cost en el cuerpo

X-HopBase-Cost-USD:opcionalstring

Importe en USD realmente descontado del saldo por esta solicitud, el mismo que su registro de uso, con hasta 8 decimales, como 0.012; solo se envía junto con X-HopBase-Cost

X-HopBase-Currency:opcionalstring

Moneda de X-HopBase-Cost, siempre CNY

id:opcionalstring

ID de esta completion

object:opcional"chat.completion"

Siempre chat.completion

created:opcionalinteger

Segundos Unix

model:opcionalstring

ID del modelo usado realmente

choices:opcionalarray of object

Respuestas candidatas; la mayoría de los modelos devuelve solo 1

usage:opcionalobject

Uso de tokens

Errores

400No se puede leer el cuerpo de la solicitud, falta messages, etc.
401Falta la clave, la clave no es válida o ha caducado (missing_api_key / invalid_api_key / api_key_expired)
402Se agotó el saldo o la cuota de la clave, del miembro o del departamento (insufficient_quota)
404El modelo no está en el grupo de esta clave (model_not_found) o la ruta no pertenece a ese grupo (route_not_found)
413El cuerpo de la solicitud supera 60 MB (request_too_large)
429Se alcanzó el límite de concurrencia de la cuenta o de la clave (user_concurrency_limit / apikey_concurrency_limit), con Retry-After

Páginas relacionadas