Bir metin yanıtı oluştur
ShareAI Yanıtlar API'sini, durumsuz metin oluşturma, açık konuşma geçmişi ve Yanıtlar akış olayları için kullanın.
Bu sayfada
https://api.shareai.now/api/v1/responsesBir istem veya konuşmadan bir metin yanıtı oluşturun.
- Temel URL
https://api.shareai.now- Kimlik doğrulama
- Bearer API anahtarı veya onaylanmış OAuth erişim jetonu
Uygulamanız Yanıtlar metin mesajı formatını kullanıyorsa bu API'yi seçin. Her istekte konuşmayı sağlayın; yanıtlar daha sonra alınmak üzere saklanmaz.
Bir istek gönder#
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/responses" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_CHAT_MODEL",
"input": "Explain semantic search in two sentences.",
"instructions": "Use plain language.",
"store": false,
"stream": false
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_CHAT_MODEL', 'input': 'Explain semantic search in two sentences.', 'instructions': 'Use plain language.', 'store': False, 'stream': False}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/responses', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/responses";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "YOUR_CHAT_MODEL",
"input": "Explain semantic search in two sentences.",
"instructions": "Use plain language.",
"store": false,
"stream": false
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
İstek alanları#
| Alan | Değer |
|---|---|
model | Kimlik bilgileriniz tarafından izin verilen bir mevcut sohbet modeli. |
input | Boş olmayan bir dize veya en fazla 256 metin mesajı. |
instructions | Konuşmaya eklenen isteğe bağlı sistem talimatları. |
store | false; yanıtların saklanması desteklenmez. |
stream | false JSON için veya true Yanıtlar SSE olayları için. |
Bir konuşmaya devam edin#
Önceki mesajları input bir sonraki kullanıcı mesajıyla birlikte gönderin. Desteklenen roller user, assistant, system ve developer. Geliştirici talimatları sistem rolünü dahili olarak kullanır. Mesaj içeriği metin veya input_text/output_text parçalar olabilir.
JSON
{
"model": "YOUR_CHAT_MODEL",
"input": [
{
"role": "user",
"content": "What is semantic search?"
},
{
"role": "assistant",
"content": "It finds results by meaning rather than exact words."
},
{
"role": "user",
"content": "Give one example."
}
],
"store": false
}
Sonucu okuyun#
JSON yanıtı bir response nesnesidir. Asistan metnini output[].content[] türü output_text. olan girdilerden okuyun. Yanıt durumunu kontrol edin: completed tamamlanmış bir yanıt; incomplete bir token sınırını gösterebilir. Genel usage şu anda null; işlenmiş kullanımı incelemek için Konsol Kullanımı'nı kullanın.
Bir yanıt akışı#
Belirleyin stream: true ve SSE'yi ayrıştırın. Olaylar şunları içerir: response.created, response.output_text.delta ve bir terminal response.completed, response.incomplete veya response.failed. Metin deltasını sırayla ekleyin ve terminal durumunu açıkça ele alın.
Desteklenen alt küme#
Bu uç nokta metin oluşturmayı destekler. Saklanan yanıtlar, previous_response_id, alma/silme, araçlar, görsel girişi, arka plan istekleri ve gibi oluşturma ayarları temperature desteklenmez ve reddedilir. Chat Completions tarafından desteklenen mesaj tabanlı oluşturma ayarları için Sohbet Tamamlamaları.
Bir OAuth erişim belirteci kullanın#
Authorization başlığındaki API anahtarını onaylanmış bir OAuth erişim belirteciyle değiştirin. surcharge Hesap tarafından finanse edilen çıkarımlar için kapsam ve kabul edilen kullanım planı gereklidir. Sadece kimlik doğrulama kapsamları harcama yetkisi vermez. Bkz. kapsamlar ve izinler.
Son güncelleme Eylül 15, 2026