POST /completions

POST https://playground.curvelabs.org/api/v1/completions

​

Headers

​

Body parameters

​

Compatibility notes

• Provide either prompt or messages.
• When using messages, include the full conversation history, put system and developer context before the final user turn, and send non-empty content in that final user message.
• messages supports user, assistant, system, and developer roles.
• model must be your persona ID UUID provided during onboarding.
• prompt must be a non-empty string or a single-element string array.
• n is capped at 5.
• Message content must be a plain string or an array of text parts.
• Optional timestamp, createdAt, and created_at values are accepted and normalized when present.
• Streaming is not supported on this V1 endpoint. stream: true returns an error.
• max_tokens and logprobs are rejected.
• Other OpenAI parameters are accepted but ignored: temperature, top_p, presence_penalty, frequency_penalty, best_of, seed, suffix, and user.
• Output text is normalized, stop sequences are applied, and echo prepends the prompt.
• Responses omit usage.

​

Request

curl -X POST https://playground.curvelabs.org/api/v1/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -d '{
    "model": "YOUR_PERSONA_ID",
    "prompt": "hey, how's your day?",
    "n": 1,
    "echo": false,
    "stop": ["\n\n"]
  }'

​

Response

{
  "id": "cmpl-...",
  "object": "text_completion",
  "created": 1737656583,
  "model": "YOUR_PERSONA_ID",
  "choices": [
    {
      "text": "pretty chill so far, you?",
      "index": 0,
      "logprobs": null,
      "finish_reason": "stop",
      "chunks": ["pretty chill so far, you?"]
    }
  ]
}