Skip to content

OpenAI Responses

POST /v1/responses

OpenAI Responses API compatible endpoint. This is a standard pass-through.

See OpenAI's documentation for the full request and response specification.

Request

bash
curl https://hyper.charm.land/v1/responses \
  -H "Authorization: Bearer sk-hyper-xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "input": "What is bubble tea?"
  }'
FieldTypeRequiredDescription
modelstringyesModel ID from /v1/models
inputstring or arrayyesA string prompt or array of message objects

All standard Responses API parameters are accepted.

Response

json
{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1718000000,
  "model": "deepseek-v4-pro",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Bubble tea is a Taiwanese drink..."
        }
      ]
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 42,
    "total_tokens": 50
  }
}

Errors

All errors use the standard OpenAI error format:

json
{
  "error": {
    "message": "...",
    "type": "...",
    "code": null
  }
}
Statuserror.typeCause
400invalid_request_errorInvalid JSON, missing model or input, context window exceeded
401authentication_errorMissing or invalid API key
402billing_errorInsufficient Hypercredits
403permission_errorForbidden
404invalid_request_errorModel not found
429rate_limit_errorRate limit exceeded
5xxserver_errorUpstream provider failure