Saltar al contenido

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.

POST/v1/responses

Endpoint 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

Authorization:obligatoriostring

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

Parámetros del cuerpoJSON

model:obligatoriostring

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

input:obligatoriostring o array of object

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

max_output_tokens:opcionalinteger

Límite de salida. El gateway no lo recorta ni lo reescribe; el máximo sigue la especificación oficial del modelo

stream:opcionalboolean

true devuelve el flujo de eventos SSE de Responses; ver Eventos de streaming

Predeterminadofalse

tools:opcionalarray of object

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

tool_choice:opcionalstring o object

Se reenvía sin cambios

reasoning:opcionalobject

Configuración de razonamiento; se reenvía sin cambios. El model_reasoning_effort de Codex CLI se escribe aquí

service_tier:opcionalstring

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

previous_response_id:opcionalstring

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

store:opcionalfalse

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

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 la respuesta (store siempre es false; no se puede recuperar por ID)

object:opcional"response"
created_at:opcionalinteger

Segundos Unix

status:opcionalstring

completed / incomplete / failed

model:opcionalstring

ID del modelo

output:opcionalarray of object

Elementos de salida: message, reasoning, function_call, etc.

usage:opcionalobject

Uso de tokens

error:opcionalobject o null

Error si falla

Errores

400No se puede leer el cuerpo de la solicitud o faltan campos
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
503Si indica que la sesión con estado "can no longer be resumed", quite previous_response_id e inicie una conversación nueva

Páginas relacionadas