API
Messages API
Use the Anthropic-compatible Messages shape for Claude-style requests.
Overview
The Messages API is designed for Claude-compatible clients. It keeps the system prompt separate from `messages` and requires `max_tokens`.
Request
`POST https://uouo.cloud/v1/messages`
Body parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | Claude-compatible model ID. |
| max_tokens | integer | Yes | Maximum output tokens. |
| messages | array | Yes | Conversation messages with `user` and `assistant` roles. |
| system | string | No | System instruction. |
| temperature | number | No | Sampling temperature. |
| stream | boolean | No | Return SSE events when true. |
| tools | array | No | Tool definitions. |
Example
curl https://uouo.cloud/v1/messages \
-H "Authorization: Bearer $UOUODUO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-3-5-sonnet-latest",
"max_tokens": 512,
"system": "You are a careful code review assistant.",
"messages": [
{ "role": "user", "content": "List three risks in this migration plan." }
]
}'Streaming
Streaming responses use Anthropic-style events such as `message_start`, `content_block_delta`, and `message_stop`. Client SDKs usually parse these events for you.
Notes
- Always set `max_tokens`.
- Keep `system` outside the `messages` array.
- Some OpenAI-only parameters may be ignored by Claude-compatible routes.
- Usage and final billing are shown in `/app/logs` and `/app/usage`.