SUsuperlinked
inference

`/v1/responses` — OpenAI Responses API (MVP, stateless single-turn).

Changed on

OpenAI Responses API (MVP). Strict allow-list parser: unknown top-level fields reject with 400 unsupported_field. input is either a string prompt OR an array of {role, content} messages. Known-rejected fields: tools, tool_choice, previous_response_id, reasoning, background, metadata, instructions — each rejects with 400 unsupported_field. stream: true is rejected (Responses SSE is deferred). Multimodal image content parts reject with 400 unsupported_field on the array form.

post/v1/responses

Request

  • The document declares no server URL.
  • Auth
    • HTTP bearer
    • or API key in header x-api-key

Headers

X-SIE-Remote'forbid'

Require local serving through a current worker execution fence. A selected remote profile returns 400; no verified local worker returns retryable 503. Duplicate or other values return 400.

Request body

max_output_tokensinteger nullable

Maximum number of generated tokens. Defaults to 16 when absent or null.

modelstring required
seedinteger nullable

Optional signed 64-bit per-request sampling seed. Reproducibility is best effort, not guaranteed, and depends on the active generation backend and deployment configuration. Non-integer or out-of-range values reject with 400 invalid_request.

streamfalse | null nullable

Accepted only as false (or absent). true rejects with 400 unsupported_field because Responses SSE is not supported yet.

temperaturenumber float nullable

Sampling temperature representable by the worker runtime.

top_pnumber float nullable

Nucleus sampling. Finite number in (0, 1].

Response

Response object

created_atinteger required
idstring required
modelstring required
object'response' required
status'completed' required

Changes

  • 5e1beae0970bRevision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property ///// to the response with the status

  • f180cec53d4fRevision changes
    • info

      added the new optional header request parameter X-SIE-Remote