Entegrasyon örnekleri

curl -s https://<gateway-host>/models \
  -H "Authorization: Bearer $CID222_API_KEY"

[
  {
    "id": "…",
    "model_name": "gpt-4o",
    "display_name": "GPT-4o (Vision)",
    "provider": { "id": "…", "code": "openai", "name": "OpenAI" },
    "supports_vision": true,
    "supports_streaming": true,
    "is_active": true,
    "created_at": "2026-01-01T00:00:00.000Z"
  }
]

curl -N -X POST https://<gateway-host>/chat/completions \
  -H "Authorization: Bearer $CID222_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "provider": "openai",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello, world!"}
    ],
    "max_tokens": 256
  }'

data: {"type":"token_usage","usage":{"prompt_tokens":21,"completion_tokens":14,"total_tokens":35}}

data: {"id":"filtered-response","content":"Hello! How can I help you today?","finish_reason":"stop","filtered":false,"entities_masked":0}

data: [DONE]

import os
 
import requests
 
 
def detect(text: str) -> dict:
    response = requests.post(
        'https://<gateway-host>/api/v1/guardrails/detect',
        headers={
            'Authorization': f'Bearer {os.environ["CID222_API_KEY"]}',
            'Content-Type': 'application/json',
        },
        json={'text': text, 'check_type': 'prompt'},
        timeout=30,
    )
    response.raise_for_status()
    return response.json()
 
 
result = detect('Email me at john@example.com')
print(result['action'])       # "mask"
print(result['maskedText'])   # "Email me at [EMAIL]"

# 1. Get a user JWT. Valid for JWT_EXPIRES_IN, 24 hours by default.
CID222_JWT=$(curl -s -X POST https://<gateway-host>/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username": "sarah_smith", "password": "<password>"}' \
  | python3 -c 'import json,sys; print(json.load(sys.stdin)["access_token"])')
 
# 2. Create the session.
curl -s -X POST https://<gateway-host>/sessions \
  -H "Authorization: Bearer $CID222_JWT" \
  -H "Content-Type: application/json" \
  -d '{"session_name": "Demo"}'
 
# 3. Send a turn. The model is chosen per message, not per session.
curl -N -X POST https://<gateway-host>/sessions/<session-id>/messages \
  -H "Authorization: Bearer $CID222_JWT" \
  -H "Content-Type: application/json" \
  -d '{"content": "What can you help me with?", "model": "gpt-4o"}'

import { useCallback, useState } from 'react';
 
type Message = { role: 'user' | 'assistant'; content: string };
 
export function useChat() {
  const [messages, setMessages] = useState<Message[]>([]);
  const [isLoading, setIsLoading] = useState(false);
 
  const sendMessage = useCallback(
    async (content: string) => {
      setIsLoading(true);
      const next: Message[] = [...messages, { role: 'user', content }];
      setMessages(next);
 
      try {
        // Your own route holds the key and pipes the gateway's SSE frames through.
        const res = await fetch('/api/chat', {
          method: 'POST',
          headers: { 'Content-Type': 'application/json' },
          body: JSON.stringify({ messages: next }),
        });
 
        const reader = res.body!.getReader();
        const decoder = new TextDecoder();
        let buffer = '';
 
        while (true) {
          const { done, value } = await reader.read();
          if (done) break;
          buffer += decoder.decode(value, { stream: true });
 
          const frames = buffer.split('\n\n');
          buffer = frames.pop() ?? '';
 
          for (const frame of frames) {
            const line = frame.split('\n').find((l) => l.startsWith('data: '));
            if (!line) continue;
            const data = line.slice(6).trim();
            if (data === '[DONE]') return;
 
            const event = JSON.parse(data);
            if (event.error) throw new Error(event.error);
            if (event.type === 'output_content_rejected') throw new Error(event.reason);
 
            // One event carries the whole answer — append it as a new message.
            if (!event.type && typeof event.content === 'string') {
              setMessages((prev) => [...prev, { role: 'assistant', content: event.content }]);
            }
          }
        }
      } finally {
        setIsLoading(false);
      }
    },
    [messages],
  );
 
  return { messages, sendMessage, isLoading };
}