Hızlı Başlangıç: Sohbet Tamamlama API'si

Önkoşullar ve temel URL

API'miz standart OpenAI sohbet tamamlama arayüzüyle tamamen uyumludur. İstek göndermeye başlamak için yalnızca bir temel URL ve bir API anahtarına ihtiyacınız vardır. Temel URL HTTPS://api.howmuchisanapikey.com/v1'dir. Bu tek uç nokta, birden fazla hizmet URL'si veya vekil yapılandırmaları yönetmenizi gerektirmeden tüm metin üretimini yönetir.

Kimlik doğrulama basittir. Bearer şemasını ve benzersiz anahtarınızı içeren bir Authorization başlığı eklemelisiniz. Sohbet tamamlama uç noktasına yapılan her istek, hesabınızı doğrulamak ve ön ödemeli kredi bakiyenize karşı token kullanımını izlemek için bu başlığı gerektirir.

Kimlik doğrulama ve headerlar

Kimliğinizi doğrulamak için her istekte Authorization başlığını dahil edin. Başlık formatı Authorization: Bearer YOUR_API_KEY şeklindedir. Anahtar geçersiz veya süresi dolmuşsa API hemen 401 hatası döndürür. Bu, yalnızca yetkili hesapların ön ödemeli kredinizi tüketmesini sağlar.

Temel metin üretimi için ek başlıklar geçmenize gerek yoktur. Ancak JSON modu veya fonksiyon çağırma gibi belirli özellikler kullanıyorsanız, Content-Type başlığını application/json olarak ayarlamanız gerekir. Bu, sunucunun istek gövdenizi doğru şekilde ayrıştırmasını sağlar.

İlk sohbet tamamlamanızı gönderme

mesaj geçmişiniz ve model kimliğiniz ile /v1/chat/completions adresine POST isteği gönderin. Model kimliği "uncensored"dir. Bu model, yasal yetişkin içeriği, kurgu veya tartışmalı konular için reddetmeler olmadan yanıt verecek şekilde ayarlanmıştır. Standart politik veya sosyal normlara göre filtreleme yapmaz.

İşte başlamanız için temel bir curl örneği:

Copycurl https://api.howmuchisanapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a simple hello world function in python"}]
  }'

Yanıt, choices dizisi içinde oluşturulan metni içerecektir. Bu metni doğrudan uygulama mantığınıza ayrıştırabilirsiniz. Her istek, girdi tokenları için prompt'unuzu ve modelin yanıtı için çıktı tokenlarını tüketir.

Akış yanıtları ve belirteç kullanımı

Sunucu Tarafı Olayları (SSE) kullanarak tokenları oluşturulurken alın. Bu, uzun çıktılar için algılanan gecikmeyi azaltır. İstek gövdesinde stream parametresini true olarak ayarlayın. Sunucu, yanıtın kısmi bir deltasını içeren birden fazla chunk gönderecektir.

Son parça kullanım verilerini içerir. Bu nesne, istek tarafından tüketilen toplam girdi ve çıktı tokenlarını içerir. Bu verileri yerel kredi bakiyenizi güncellemek veya harcamalarınızı gerçek zamanlı olarak izlemek için kullanabilirsiniz. Akış, kullanıcıların anında geri bildirim beklediği sohbet arayüzleri için idealdir.

Fonksiyon çağırma ve JSON modu

API, JSON modu ve fonksiyon çağırma aracılığıyla yapılandırılmış çıktı desteği sunar. Modelin geçerli JSON döndürmesini zorlamak için response_format'i {"type": "json_object"} olarak ayarlayın. Bu, veri çıkarma veya ayrıştırma hataları olmadan yapılandırılmış yapılandırmalar oluşturmak için kullanışlıdır.

Fonksiyon çağırma için isteğinizde bir tools dizisi sağlayın. Model, bir işleve ihtiyaç duyulduğunu belirlediğinde tool_calls ile yanıt verecektir. Ardından işlevi çalıştırabilir ve sonucu modele gönderebilirsiniz. Bu, harici ayrıştırma mantığı olmadan karmaşık çok adımlı iş akışlarını mümkün kılar.

Limitleri ve hataları işleme

Dakikada 300 isteğe ve anahtar başına eşzamanlı istekler 8 ile sınırlıdır. Bu limitleri aşarsanız 429 Too Many Requests hatası alırsınız. Yanıt gövdesi retry-after bilgilerini içerecektir. Gereksiz yeniden denemelerden kaçınmak için istemci tarafındaki kısıtlamayı ayarlayın.

Ön ödemeli krediniz tükendiğinde API, 402 Payment Required hatasını döndürür. Kripto ile herhangi bir zamanda yükleme yapabilirsiniz. Hatalar ve reddetmeler ücretsizdir, bu nedenle yalnızca başarılı token üretimi için ödeme yaparsınız. Bağlam penceresi, istem ve tamamlama birlikte 100,000 token içindir.

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.howmuchisanapikey.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.howmuchisanapikey.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Akış

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)