Chat Completions

NOXERY API

Chat Completions

Short, direct guides for using the OpenAI-compatible API in your applications and agents.

POST `/v1/chat/completions`

Mesaj tabanlı sohbet, function calling ve streaming için varsayılan uç. OpenAI Chat Completions istemci biçimiyle çalışır.

Header'lar

http

Authorization: Bearer nox-YOUR_API_KEY
Content-Type: application/json

Parametreler

Alan	Gerekli	Açıklama
messages	Evet	Mesaj dizisi. Boş veya eksikse `400` döner.
model	Hayır	`/v1/models` yanıtındaki ID. Verilmezse hesap varsayılanı kullanılır; bilinmeyen ID `404` döner.
stream	Hayır	`true` ise SSE akışı döner. Varsayılan `false`.
max_completion_tokens	Hayır	Yanıt üst sınırı. `max_tokens` yedeği okunur; hiçbiri yoksa 8192 uygulanır.
temperature, top_p	Hayır	Upstream'e iletilir. Reasoning modellerinde yoksayılabilir.
tools, tool_choice, parallel_tool_calls	Hayır	Function calling. `tools` yoksa ilgili alanlar yoksayılır.
reasoning_effort	Hayır	Destekleyen modellere iletilir. Desteklenmeyen değer `400` dönebilir.
stop, n, seed, frequency_penalty, presence_penalty, logit_bias, logprobs, top_logprobs, response_format, stream_options, user, service_tier, store, modalities, audio, prediction, functions, function_call	Hayır	Upstream'e iletilir.
metadata	—	İletilmez, yoksayılır.

messages biçimi

Roller: system, developer, user, assistant, tool. content düz string veya parça dizisi olabilir. Görsel parça image_url anahtarı taşır ve modelin image modalitesi gerekir.

json

{
  "model": "deepseek-v4-pro-202606",
  "messages": [
    {"role": "system", "content": "Yanıtları kısa yaz."},
    {"role": "user", "content": "Bir deploy kontrol listesi hazırla."}
  ],
  "max_completion_tokens": 1024,
  "stream": false
}

Görsel örnek:

json

{
  "role": "user",
  "content": [
    {"type": "text", "text": "Bu grafikte ne görüyorsun?"},
    {"type": "image_url", "image_url": {"url": "https://ornek.com/grafik.png"}}
  ]
}

Assistant'ın tool_calls içeren mesajı ile karşılığındaki tool sonucu birlikte gönderilmelidir; tek tarafı eksik istek upstream'de reddedilebilir. Detaylı akış için Tool calling sayfasına bak.

Yapısal çıktı

Yanıtı JSON şemaya kilitle: response_format içinde {"type": "json_schema", "json_schema": {"name": ..., "schema": ..., "strict": true}} gönder. Serbest JSON için {"type": "json_object"} yeter. Bozuk şema faturalandırmadan önce 400 ile reddedilir.

json

"response_format": {"type": "json_schema", "json_schema": {"name": "kisi", "strict": true, "schema": {"type": "object", "properties": {"ad": {"type": "string"}}, "required": ["ad"], "additionalProperties": false}}}

Yanıt

json

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1758000000,
  "model": "deepseek-v4-pro-202606",
  "choices": [
    {
      "index": 0,
      "message": {"role": "assistant", "content": "1. Değişiklikleri gözden geçir..."},
      "finish_reason": "stop"
    }
  ],
  "usage": {"prompt_tokens": 24, "completion_tokens": 60, "total_tokens": 84}
}

model alanı istekte gönderdiğin ID'yi yansıtır. finish_reason length ise yanıt token sınırında kesilmiş demektir; limiti artırıp tekrar dene.

curl

curl https://api.noxery.net/v1/chat/completions \
  -H "Authorization: Bearer $NOXERY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-pro-202606","messages":[{"role":"user","content":"Merhaba"}]}'

Chat Completions