Crear una respuesta
OpenAI Responses API: la usan Codex CLI y modelos como GPT, Qwen, DeepSeek y Grok; sin estado, cada turno debe enviar el historial completo.
/v1/responsesEndpoint compatible con OpenAI Responses; Codex CLI lo usa. En HopBase, Responses es sin estado: store siempre es false y previous_response_id se elimina, así que en conversaciones de varios turnos envíe el input completo cada vez.
Los campos no listados se reenvían sin cambios; cada página de modelo indica si los campos que el modelo no acepta (como truncation y reasoning.summary en DeepSeek) se eliminan sin aviso. Si la salida en streaming falla a mitad, se envía event: response.failed y el estado HTTP sigue siendo 200.
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
Bearer sk-…: una clave de API creada en la consola; su grupo debe incluir el modelo solicitado
Parámetros del cuerpoJSON
Un ID de modelo del grupo de la clave actual. Grupos con Responses: GPT (Codex, Azure), Qwen, DeepSeek (incluida la región de EE. UU.), GLM de la región de EE. UU., Grok, Kimi serie K3 autoalojado, Gemini económico (AI Studio / Vertex) y Gemini oficial directo (empresarial). GLM-5.3, GLM-5.3 Flash y el grupo Kimi K3 en la nube no lo admiten
Una cadena se envuelve automáticamente en un único mensaje de usuario; también acepta un array de mensajes. En Qwen, las partes de contenido solo admiten input_text, input_image e input_file, sin video
user / assistant / system / developer
Cadena o array de partes de contenido
Límite de salida. El gateway no lo recorta ni lo reescribe; el máximo sigue la especificación oficial del modelo
true devuelve el flujo de eventos SSE de Responses; ver Eventos de streaming
Predeterminadofalse
Definiciones de herramientas; se reenvían sin cambios. En Responses las herramientas de función son planas (name al mismo nivel que type), a diferencia de Chat Completions
function o un tipo de herramienta del servidor que admita el modelo
Nombre de la función
Para qué sirve la función
JSON Schema de los parámetros
Se reenvía sin cambios
Configuración de razonamiento; se reenvía sin cambios. El model_reasoning_effort de Codex CLI se escribe aquí
GPT: low / medium / high / xhigh; cuanto más alto el nivel, más razona y más tokens consume. grok-4.20-multi-agent-0309 lo usa para controlar cuántos agentes colaboran
Solo se conservan priority / flex; los demás valores se eliminan antes de reenviar. 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
No admitido: el gateway elimina este campo y no continúa el turno anterior. En conversaciones de varios turnos, incluya el historial completo en input
Siempre false: el servidor no guarda la respuesta y no se puede recuperar después por ID
Predeterminadofalse
Respuesta
200Éxito. Sin streaming es un JSON response; con stream: true es SSE
Encabezados de respuesta
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
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
Moneda de X-HopBase-Cost, siempre CNY
ID de la respuesta (store siempre es false; no se puede recuperar por ID)
Segundos Unix
completed / incomplete / failed
ID del modelo
Elementos de salida: message, reasoning, function_call, etc.
message / reasoning / function_call
assistant en message
Partes de contenido de message
output_text
Texto de salida
function_call: nombre de la función
function_call: argumentos como cadena JSON
function_call: se referencia al devolver el resultado
Uso de tokens
Tokens de entrada
Tokens de salida, incluidos los de razonamiento
Total
De ellos, tokens de razonamiento
Añadido por la pasarela: el cargo de esta solicitud en CNY (el mismo cargo que cost_usd), igual que el encabezado X-HopBase-Cost; no se devuelve en streaming
Añadido por la pasarela: el importe en USD realmente descontado del saldo, igual que el encabezado X-HopBase-Cost-USD y el registro de uso; no se devuelve en streaming
Añadido por la pasarela: la moneda de cost, siempre CNY
Error si falla
Errores
missing_api_key / invalid_api_key / api_key_expired)insufficient_quota)model_not_found) o la ruta no pertenece a ese grupo (route_not_found)request_too_large)user_concurrency_limit / apikey_concurrency_limit), con Retry-Afterprevious_response_id e inicie una conversación nueva