API Reference

POST /v1/chat

Primary endpoint for conversational AI applications.

Endpoint reference

POST/v1/chat

Send a message history and receive a model-generated assistant response.

Authentication: Authorization: Bearer YOUR_API_KEY
Request examples
curl https://api.deepconrad.com/v1/chat \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "conrad-4.0",
    "messages": [
      {"role": "user", "content": "Write a concise welcome message for new users."}
    ]
  }'
Response example
{
  "id": "chat_01JCHAT",
  "object": "chat.response",
  "model": "conrad-4.0",
  "output": [
    {
      "role": "assistant",
      "content": "Welcome to Conrad AI. Here is a concise message you can use..."
    }
  ],
  "usage": {
    "input_tokens": 24,
    "output_tokens": 51,
    "total_tokens": 75
  }
}
Parameters
ParameterTypeRequiredDescription
modelstringYesModel ID such as conrad-3.1, conrad-4.0, or conrad-5.0.
messagesarrayYesOrdered chat messages with role and content.
streambooleanNoEnable partial streaming output.
temperaturenumberNoAdjust variation and creativity.
max_output_tokensintegerNoUpper output token limit.
Error handling
StatusMeaningNotes
400Invalid request bodyCheck JSON formatting and field names.
401UnauthorizedAdd a valid bearer token.
429Rate limitedRetry with backoff.
500Internal errorRetry and contact support if persistent.