Chat Completions

curl -H "X-API-Key: ziri-user-123-a1b2c3d4e5f67890" \
  https://your-server.com/api/chat/completions

{
  provider: string          // Required: "openai", "anthropic", etc.
  model: string             // Required: "gpt-4", "claude-3-opus", etc.
  messages: Array<{         // Required: Conversation messages
    role: string            // "system", "user", "assistant"
    content: string         // Message content
  }>
  max_tokens?: number       // Optional: Maximum tokens in response
  temperature?: number      // Optional: 0-2, controls randomness
  top_p?: number           // Optional: Nucleus sampling
  frequency_penalty?: number // Optional: -2 to 2
  presence_penalty?: number  // Optional: -2 to 2
  stop?: string[]          // Optional: Stop sequences
  stream?: boolean         // Optional: Stream responses (not yet supported)
  // ... other provider-specific parameters
}

curl -X POST http://localhost:3100/api/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ziri-user-123-a1b2c3d4e5f67890" \
  -d '{
    "provider": "openai",
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "Hello, ZIRI!"}
    ],
    "max_tokens": 100
  }'

{
	"id": "chatcmpl-123",
	"object": "chat.completion",
	"created": 1704067200,
	"model": "gpt-4o-mini",
	"choices": [
		{
			"index": 0,
			"message": {
				"role": "assistant",
				"content": "Hello! How can I help you?"
			},
			"finish_reason": "stop"
		}
	],
	"usage": {
		"prompt_tokens": 10,
		"completion_tokens": 8,
		"total_tokens": 18
	}
}

{
	"error": "API key required. Include X-API-Key header.",
	"code": "API_KEY_REQUIRED",
	"requestId": "req-123"
}

{
	"error": "Invalid API key format",
	"code": "INVALID_API_KEY_FORMAT",
	"requestId": "req-123"
}

{
	"error": "API key not found or invalid",
	"code": "API_KEY_INVALID",
	"requestId": "req-123"
}

{
	"error": "provider, model, and messages are required",
	"code": "MISSING_FIELDS",
	"requestId": "req-123"
}

{
	"error": "Rate limit exceeded",
	"code": "RATE_LIMIT_EXCEEDED",
	"requestId": "req-123",
	"retryAfter": 15,
	"resetAt": "2025-01-01T12:00:00Z"
}

{
	"error": "Server busy - queue full",
	"code": "QUEUE_FULL",
	"requestId": "req-123"
}

{
	"error": "Authorization denied: Policy policy1 denied the request",
	"code": "AUTHORIZATION_DENIED",
	"reason": "Policy policy1 denied the request",
	"requestId": "req-123"
}

{
	"error": "Provider not found",
	"code": "PROVIDER_NOT_FOUND",
	"requestId": "req-123"
}

{
	"error": "Provider API key not configured",
	"code": "PROVIDER_KEY_MISSING",
	"requestId": "req-123"
}

{
	"error": "OpenAI API error: Rate limit exceeded",
	"code": "LLM_PROVIDER_ERROR",
	"requestId": "req-123"
}

import { UserSDK } from "@ziri/sdk";

const sdk = new UserSDK({
	apiKey: "ziri-user-123-a1b2c3d4e5f67890",
	proxyUrl: "http://localhost:3100",
});

const response = await sdk.chatCompletions({
	provider: "openai",
	model: "gpt-4o-mini",
	messages: [{ role: "user", content: "Hello, ZIRI!" }],
	max_tokens: 100,
});

console.log(response.choices[0].message.content);