Skip to main content
POST
Create a chat completion

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Headers

x-veryfront-project-reference
string

Project UUID or slug used to attribute billing finalization.

Required string length: 1 - 255
x-veryfront-project-id
string

Project ID used to attribute billing finalization.

Required string length: 1 - 255
x-veryfront-project-slug
string

Project slug used to attribute billing finalization.

Required string length: 1 - 255
x-veryfront-agent-run-id
string

Durable run ID. Required for run-bound service-account credentials.

Required string length: 1 - 245
x-veryfront-conversation-id
string

Durable conversation ID. Required with agent run attribution.

Required string length: 1 - 255
x-veryfront-message-id
string

Durable message ID. Required with agent run attribution.

Required string length: 1 - 255
x-veryfront-agent-id
string

Agent ID. Must match the authenticated run-bound credential.

Required string length: 1 - 255
x-veryfront-billing-group-id
string

Optional billing group. Run requests are pinned to agent-run:.

Required string length: 1 - 255

Body

application/json
model
string
required

Catalog model ID or alias. Required: the request is routed by model, not by base URL.

messages
any[]
required

Vendor-shaped messages, forwarded as sent.

Response

Upstream provider response (forwarded as-is)