API Reference

POST /v1/completions

Single-shot completions for prompt-driven workflows.

Endpoint reference

POST/v1/completions

Send a prompt and receive a single completion response.

Authentication: Authorization: Bearer YOUR_API_KEY
Request examples
curl https://api.deepconrad.com/v1/completions \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "conrad-4.0",
    "prompt": "Write a concise release note for a dashboard refresh.",
    "max_output_tokens": 180
  }'
Response example
{
  "id": "cmpl_01JCOMP",
  "object": "completion.response",
  "model": "conrad-4.0",
  "text": "We refreshed the dashboard to improve clarity and speed.",
  "usage": {
    "input_tokens": 14,
    "output_tokens": 26,
    "total_tokens": 40
  }
}
Parameters
ParameterTypeRequiredDescription
modelstringYesThe Conrad model to use.
promptstringYesThe input prompt.
max_output_tokensintegerNoMaximum length of generated output.
temperaturenumberNoControls variability and creativity.
Error handling
StatusMeaningNotes
400Invalid payloadCheck required fields and types.
401UnauthorizedUse a valid bearer token.
429Rate limitedRetry gradually.
500Internal errorRetry and monitor logs if it persists.