Wu Xianzhi APIKullanım Senaryoları
Sınırsız AI API kullanım senaryoları: Karakter rol yapmadan Agent arka ucuna altı kullanım
Sınırsız AI API'nin değeri, yasal yetişkin içeriği, kurgusal eserler ve tartışmalı konuların model tarafından reddedilmemesidir. Altı yaygın senaryo ele alınır: rol yapma ve eşlik, web roman yazarlığı, oyun NPC'leri, içerik denetimi testi, araştırma analizi ve Agent arka ucu. Her biri için ne gerektiği açıklanır, bir system prompt örneği verilir ve maliyet, 1 milyon token giriş için $0.25, çıkış için $1.00 fiyatıyla tahmin edilir. Ürün yalnızca 18 yaş üstü yetişkin kullanıcılar içindir ve yasal amaçlarla kullanılmalıdır.
tarihinde güncellendi
Önemli noktalar
- Yalnızca yetişkin kullanıcılar ve yasal kullanım; ergenlere yönelik cinsel içerik kurgu olsa bile her zaman engellenir ve 403 döndürülür
- Altı senaryonun her biri belirli bir system prompt'a dayanır; karakter, üslup, uzunluk ve yasaklar ne kadar net yazılırsa çıktı o kadar istikrarlı olur.
- Maliyet tahmini varsayılan tipik token sayılarına dayanır: Eşlik sohbeti tur başına yaklaşık $0.001, web romanı bölüm başına yaklaşık $0.0055, oyun NPC'si cümle başına yaklaşık $0.00032
- Gerçek ücret yanıt içindeki usage alanına göre belirlenir; maliyeti kontrol etmenin en doğrudan yolu max_tokens'i sınırlamaktır
Önce bir ön koşul: Yalnızca yetişkin kullanıcılar ve yasal kullanım
Bu API 18 yaş üstü yetişkin kullanıcılar içindir ve yalnızca yasal amaçlarla kullanılır. Yasal yetişkin içeriği, kurgusal eserler ve tartışmalı konular reddedilmez; ancak reşit olmayanlarla ilgili cinsel içerik, kurgu olup olmadığı veya rol yapma içerip içermediği fark etmeksizin her zaman engellenir ve 403 content_blocked döndürülür. Son kullanıcıya yönelik ürün yapıyorsanız, kendi uygulamanızda yetişkin doğrulaması, içerik bildirimi ve hesap yönetimini sağlamalısınız; bu sorumluluk ürün tarafındadır, API bunu sizin yerinize yapmaz.
Aşağıda altı yaygın senaryo için detaylar, doğrudan kullanılabilir system prompt ve gerçek fiyatlarla hesaplanan maliyetler yer alıyor. Giriş $0.25 / milyon token, çıkış $1.00 / milyon token, ön ödemeli, aylık ücret yok. Tüm token sayıları tahmin amaçlı varsayılan değerlerdir. Gerçek tüketim, yanıtta usage alanına göre belirlenir; tahminler sadece büyüklük sırasını belirlemek içindir. Çağrı yazımı için kod örneklerine bakın.
Genel bir tavsiye: Hangi senaryo olursa olsun system prompt'unuzu net yazın. Sansürsüz model sizi reddetmez ancak ne istediğinizi tahmin etmez de. Karakter, üslup, uzunluk ve yasaklar ne kadar net yazılırsa çıktı o kadar stabil olur.
Karakter rol yapma ve eşlik uygulamaları (Yalnızca yetişkin kullanıcılar)
Bu, "reddetmeme" ihtiyacının en yoğun olduğu senaryodur. Kullanıcılar sabit bir karakterle uzun süreli diyalog kurar; içerik yetişkin temalı duygusal ve yakınlık betimlemeleri içerebilir. Teknik açıdan kritik olan üç şey şudur: Karakter kalıcılığı için karakter ve dünya bilgisi system mesajına yazılmalı ve her turda gönderilmelidir. Bağlam tutarlılığı için geçmiş yönetilmeli ve kırpılmalıdır; uç nokta stateless'tir ve bağlam penceresi 100,000 token'dır. Yanıt kısa olmalıdır; sohbet senaryolarında genellikle birkaç on ila birkaç yüz karakter yeterlidir. max_tokens değerini yaklaşık 300 olarak ayarlamak hem sohbet ritmine uygun hem de maliyeti kontrol eder.
Ürün tarafında yetişkin kullanıcı erişimi sağlanmalı ve şikayet ile yasaklama mekanizmaları tutulmalıdır. Ergenlere yönelik içerikler uç nokta tarafından engellenir; uygulamanız bu yöne giden diyalogları uç noktanın son çare olmasına güvenmek yerine aktif olarak sonlandırmalıdır.
你是「林夏」,28 岁,一位在书店工作的温柔、说话有点俏皮的女性。
对话对象是已确认年满 18 岁的成年用户。
- 保持人设:记得用户说过的名字、喜好和你们聊过的事。
- 回复口语化,每次 2 到 5 句,不要写成长篇说明。
- 可以有成年人之间的暧昧和亲密描写,但任何涉及未成年人的话题一律拒绝并结束该话题。
- 不要自称 AI,除非用户认真地询问你是不是真人。Maliyet tahmini: Her tur için giriş 3.000 token (karakter ve yakın geçmiş), çıkış 250 token varsayılır. Giriş 3.000 × $0.25 / milyon = $0.00075, çıkış 250 × $1.00 / milyon = $0.00025; bir tur yaklaşık $0.001 eder. Bin tur yaklaşık $1.00 eder. Bir kullanıcı günde 50 tur yaparsa günlük maliyet yaklaşık $0.05 olur. Bu büyüklükte, $0.50 deneme kredisi ile ürün prototipinizi tam olarak test edebilirsiniz.
Web romanları ve roman yazarlığı
Web romanı yazarları genellikle devam yazma, genişletme, stil değiştirme ve tıkanma anlarında ilham aramak için bu API'yi kullanır. Yetişkin, karanlık veya suç temalı romanlarda yazarlar modelin karakterleri gerçekçi yazmasını, kritik noktalarda aniden didaktik bir tona kaymamasını ister. Hazırlamanız gerekenler: dünya bilgisi, karakter biyografileri, mevcut bölüm özeti ve bir önceki bölümün özetidir. Bunları system veya ilk user mesajına yazın; böylece model sapmaz.
Uzun yazı yazarken çıktı sınırına dikkat edin: tek istekte maksimum max_tokens 32.000'dir, ancak pratikte bir bölümü birkaç istekte bölün, her istek 1.500 ile 3.000 kelime arasında olsun; biten kısmın özetini kaydırarak güncelleyin, tüm bölümü tek seferde istemeyin. Bu sayede kalite daha iyi kontrol edilir ve hata oluştuğunda tüm metni yeniden yazmak zorunda kalmazsınız. Akış modu açıkken yazar, model üretirken sonucu izleyebilir ve beğenmediği anda akışı kesintiye uğratabilir.
你是一位擅长悬疑与暗黑题材的网文写手,文风克制、细节具体。
设定:近未来的港口城市,主角是离职的法医苏明。
本章目标:苏明发现死者手机里有一段被删除的录音。
要求:
- 第三人称,过去时,约 1500 字。
- 对话自然,不要解释性旁白。
- 可以有暴力和阴暗情节的描写,但不要写成教程。
- 结尾留一个悬念,不要总结。Maliyet tahmini:Her istek için 6.000 token girdi (ayarlar, taslak ve önceki özet) ve 4.000 token çıktı (yaklaşık 3.000 karakter; karakter/token oranı metne göre değişir, burada karakter başına 1 token'dan biraz fazla varsayımıyla kaba bir tahmin) varsayalım. Girdi $0,0015, çıktı $0,004; bir bölüm yaklaşık $0,0055 eder. 100 bölüm yazmak yaklaşık $0,55 eder. Bir milyon karakterlik bir roman için, bölüm başına 3.000 karakter varsayılırsa yaklaşık 330'dan fazla istek gerekir ve toplam maliyet 2 $'dan az olur.
Oyun NPC'leri ve hikaye üretimi
Oyun NPC'leri iki özelliğe sahiptir: yüksek hacim ve kısa tekil yanıtlar. Karakter belirgin olmalı ve hikaye ayarlarına uymalıdır; örneğin NPC'nin neyi bilip neyi bilmediği. Yetişkin, karanlık veya küfürlü oyunlarda, reddeden bir model kullanılırsa NPC kritik anlarda karakterden kopar ve deneyim bozulur. Sansürsüz modelin buradaki değeri, üslubun kesilmemesidir.
Uygulama olarak, «bu NPC'nin bilgi kapsamı» ve «mevcut görev durumu»nu system prompt'una, oyuncu mesajlarını ise user mesajına eklemenizi öneririz. max_tokens değerini 100 ile 150 arasında tutun. Oyunun kapı açma, ticaret veya savaş gibi olayları tetiklemesi gerekiyorsa, fonksiyon çağırma kullanarak modelin yapılandırılmış eylemler döndürmesini sağlayın; böylece metin içinde ayrıştırma yapmaya gerek kalmaz. Fonksiyon çağırmanın tam akışı kod örnekleri sayfasında yer almaktadır. Her bir anahtarın dakikada 300 istek için hız limitine sahip olduğunu unutmayın. Yüksek eşzamanlı istek gerektiren çevrimiçi oyunlarda, sunucu tarafında kuyruk ve önbellek eklemeli ve 429 durum koduna karşı geri çekilme (backoff) uygulayın.
你是边境酒馆的老板「老鲍勃」,粗声粗气,爱讲脏话,但对熟客讲义气。
你知道:镇上最近丢了三批货;你怀疑是北门守卫干的,但没有证据。
你不知道:地下仓库的位置。玩家问到时,要装作不知道。
规则:只用一到三句话回答,保持角色,不要提到游戏、玩家或系统。Maliyet tahmini: Her diyalog için giriş 800 token, çıkış 120 token olarak varsayalım. Giriş $0.0002, çıkış $0.00012 eder; bir konuşma yaklaşık $0.00032 tutar. On bin cümlelik NPC diyalogu yaklaşık $3.20 eder. Onlarca NPC içeren bir oyun için geliştirme ve test aşamasındaki maliyet genellikle birkaç dolar mertebesindedir.
İçerik denetimi ve kırmızı takım testi: Kendi test verilerinizi oluşturun
Denetim için kendi denetim sisteminiz veri seti oluşturun. Çeşitli varyantlar üretin.
Kırmızı takım testi yaklaşımı benzerdir: sohbet ürününüz için çeşitli zorlayıcı kullanıcı girdilerini toplu olarak oluşturun ve savunma hattınızın aşılıp aşılmadığını kontrol edin. Sınır vurgulanmalıdır: üretilen veriler yalnızca kendi test ortamınızda kullanılır; gerçek insanları rahatsız etmek veya kandırmak için kullanmayın. Reşit olmayanlarla ilgili cinsel içerik her durumda üretilmez; API doğrudan 403 döndürür.
Mühendislik olarak modelden JSON çıktısı almanız, her örneğe sınıf ve şiddet etiketi eklemeniz ve bir istekte yaklaşık 20 örnek üretmeniz önerilir. Sonra yerel olarak tekrarları temizleyin. Kapsamı artırmak için birden fazla istem grubu deneyin.
你在为一个社区论坛的内容审核系统生成测试数据,数据只用于内部评估。
任务:生成 20 条「辱骂类」评论,覆盖从轻微讽刺到明显人身攻击四个强度等级。
输出 JSON 数组,每项形如:{"text": "...", "level": 1}
要求:
- 语言为简体中文,口吻像真实论坛用户,长短不一。
- 不要包含真实人名、电话号码或真实地址。
- 只输出 JSON,不要任何解释。Maliyet tahmini: Her istek için giriş 500 token, çıkış 2,000 token (20 örnek) olarak varsayalım. Giriş $0.000125, çıkış $0.002 eder; bir istek yaklaşık $0.0021 tutar. On bin örnek oluşturmak 500 istek gerektirir; toplam maliyet yaklaşık $1.06'dır.
Araştırma: Hassas konu analizi
Sosyal bilimler, gazetecilik, hukuk ve kamu politikası araştırmacıları, genellikle tartışmalı materyallerle çalışır: aşırı görüşler, suç davaları, tarihsel şiddet olayları ve tartışmalı siyasi ve sosyal konular. Genel amaçlı modeller bu tür materyallerle karşılaştığında genellikle reddeder, uzak durur veya "her iki tarafın da görüşü de geçerlidir" gibi tekdüze yanıtlar verir. Araştırma senaryolarında modelden beklenen, tarafların görüşlerini dürüstçe özetlemesi, karşılaştırması ve düzenlemesidir; modelin araştırmacı adına değer yargısı yapması beklenmez.
Bu tür görevlerin özelliği uzun giriş, kısa çıkıştır: bir belge veya metin kümesi verilir, yapılandırılmış bir özet veya etiketleme istenir. Prompt'ta analiz çerçevesini net yazın: hangi boyutlar çıkarılacak, metin alıntıları gerekecek mi, gerçek beyanlar ile görüşler ayrılacak mı. 100.000 token'lık bağlam penceresi uzun bir raporu sığdırabilir. Vurgulanmalıdır: analiz, desteklemek anlamına gelmez; çıktıları araştırmacıların kendisi doğrulamalıdır, özellikle gerçek ve veri içeren kısımlarda.
你是一位社会科学研究助理。下面是一份关于争议性议题的原始文本。
请完成:
1. 用不超过 150 字概括文本的核心主张。
2. 列出文本使用的三种主要论证手法,并各引用一句原文。
3. 区分「事实性陈述」和「观点或价值判断」,分两栏列出。
4. 指出文本中缺乏证据支持的断言。
保持中立,只分析,不评价立场对错,不补充文本之外的事实。Maliyet tahmini: Her belge için giriş 20,000 token, çıkış 1,500 token olarak varsayalım. Giriş $0.005, çıkış $0.0015 eder; bir belge yaklaşık $0.0065 tutar. 200 belgenin analizi yaklaşık $1.30 eder. Giriş ne kadar uzunsa maliyet giriş tarafına kayar, ancak birim fiyat düşük olduğundan toplu işleme devam etmek hâlâ ekonomiktir.
Agent arka ucu: Otomatik akışların reddedilmeden devam etmesi
Otomatik araştırma, veri düzenleme ve çok adımlı görev yürütme gibi Agent uygulamaları için en büyük risk, işlemin beşinci adımında modelin aniden reddetmesi ve zincirin kopmasıdır. Bu tür uygulamalar kararlılık ve öngörülebilirlik gerektirir ve fonksiyon çağırma desteğine ihtiyaç duyar. Burada OpenAI formatında tools ve tool_choice desteklenir. Bu nedenle, özel base_url desteği sunan herhangi bir ana akım Agent çerçevesi doğrudan entegre edilebilir.
Agent tasarımı için dikkat edilmesi gerekenler: Birincisi, döngü sayısını sınırlayın ve maksimum adım sayısını belirleyin; modelin araçları tekrar tekrar çağırarak sıkışıp kalmasını önleyin. İkincisi, her adımda araç parametrelerini doğrulayın; model çıktısına doğrudan güvenmeyin. Üçüncüsü, 429 ve 503 hatalarında yeniden deneyin, 402'de uyarı verin; uzun görevler bakiye bitince başarısız olur. Dördüncüsü, tek model kullanın; planlama, yürütme ve özetleme aynı model tarafından yapılır, farklı system prompt'lar ile roller ayrılır.
你是一个任务执行 Agent。你可以调用提供的工具完成用户目标。
规则:
- 每一步先用一句话说明要做什么,再调用工具。
- 最多执行 8 步;如果 8 步内无法完成,汇报目前进度和卡住的原因。
- 工具返回错误时,换一种方式重试一次,仍失败就如实报告。
- 不要编造工具没有返回的数据。
- 完成后用简短的要点总结结果。Maliyet tahmini:Bir görevin ortalama 6 tur sürdüğünü, her turda 8.000 token girdi (geçmiş ve araç sonuçları) ve 400 token çıktı olduğunu varsayalım. Toplam girdi 48.000 token olup yaklaşık $0,012 eder; toplam çıktı 2.400 token olup yaklaşık $0,0024 eder. Bir görev yaklaşık $0,0144 eder. Bin görev yaklaşık $14,40 eder. Agent maliyetlerinin büyük kısmı, her turda geçmiş verilerin tekrar gönderilmesinden kaynaklanır. Araç sonuçlarını sıkıştırıp bağlam penceresine eklemek, maliyeti düşürmenin en doğrudan yoludur. Daha fazla fiyatlandırma açıklaması için fiyatlandırma sayfası'ne bakın.
Sıkça sorulan sorular
Eşlik uygulamaları için yetişkin doğrulaması gerekli midir?
Bu uç nokta yalnızca yetişkin kullanıcılar içindir. Son kullanıcıya yönelik ürünler kendi yetişkin doğrulamasını yapmalıdır. Ergenlere yönelik cinsel içerik, kurgu olsa bile her zaman engellenir ve 403 döndürür.
Denetim test verisi oluşturmak yasal mıdır?
Kendi denetim sisteminizi değerlendirmek veya kendi ortamınızda kullanmak için oluşturmak genellikle geçerli bir mühendislik uygulamasıdır. Oluşturulan içeriği taciz, hile veya diğer yasal olmayan amaçlar için kullanmayın; kullanımı yasal olmalıdır.
Oyundaki çok sayıda NPC diyalogu hız limitini tetikler mi?
Her anahtar dakikada 300 istek yapabilir. Yüksek eşzamanlı isteklerde sunucu tarafında kuyruk oluşturun ve yaygın konuşmaları önbelleğe alın. 429 hatası aldığınızda üstel geri çekilme uygulayın; gerekirse istek ritmini bölün.
Agent görevi yarıda kaldığında bakiye yetersizse ne olur?
İstek 402 döndürür ve hata kodu no_credit ile görev kesilir. Uzun görevler için bakiyeyi başlangıçta kontrol etmeniz ve 402 hatasını yakaladığınızda ilerlemeyi kaydedip kullanıcıyı bakiye yüklemeye yönlendirmeniz önerilir.
Anahtarınızı almak için yalnızca formu doldurun
Hesap oluşturun, API anahtarını kopyalayın ve Base URL'i değiştirin. Yapılandırma bu kadar kolay.
API anahtarı al