Ses oluştur
ShareAI uç noktası, sınırlı bir JSON ses sonucu döndürür.
Bu sayfada
https://api.shareai.now/api/v1/audio/generationsSes oluştur
- Temel URL
https://api.shareai.now- Kimlik doğrulama
- Bearer API anahtarı veya onaylanmış OAuth erişim jetonu
- Gerekli kapsam
inferenceormonetization_gateway
ShareAI uç noktası, sınırlı bir JSON ses sonucu döndürür. Ses üreten taleplerle modalities:["text","audio"] ayrıca kullanabilirsiniz /api/v1/chat/completions. Talebiniz, belirtilen ses işlemine yönlendirilir. Bu senkron yanıt, dönüş öncesinde toplanır; tamamlanmamış sağlayıcı akışları başarılı faturalandırılmış sonuçlar haline gelmez. Ses çıkış formatları modeline bağlı olarak mp3, wav, flac, pcm16 veya pcm24'tür. Ham PCM, süre tarifesini destekleyemez. Üretilen tokenları sınırlamak için ya max_tokens ya da max_completion_tokens ayarlayın; her ikisini birden sağlamayın.
Başlamadan önce#
SHAREAI_API_KEY'i sunucunuzda ayarlayın ve model yer tutucusunu şu anda etkin olan bir modelle değiştirin. API anahtarını tarayıcı kodunda asla ifşa etmeyin. Model, hesap, kimlik bilgisi ve sağlayıcı bu işlemi izin vermelidir. Aşağıdaki isteğe bağlı ayarlar model desteği gerektirir; API güvenlik sınırları, her modelin her değeri desteklediği anlamına gelmez.
Bir istek gönder#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/generations" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_AUDIO_MODEL",
"messages": [
{
"role": "user",
"content": "A short instrumental melody."
}
],
"modalities": [
"text",
"audio"
],
"audio": {
"format": "mp3"
},
"max_completion_tokens": 1024
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_AUDIO_MODEL',
'messages': [{'role': 'user', 'content': 'A short instrumental melody.'}],
'modalities': ['text', 'audio'],
'audio': {'format': 'mp3'},
'max_completion_tokens': 1024}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/generations', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/audio/generations", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_AUDIO_MODEL",
"messages": [
{
"role": "user",
"content": "A short instrumental melody."
}
],
"modalities": [
"text",
"audio"
],
"audio": {
"format": "mp3"
},
"max_completion_tokens": 1024
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);İstek alanları#
| Alan | Tür | Anlam ve sınırlar |
|---|---|---|
model gerekli | metin dizisi | Tam etkinleştirilmiş genel model tanımlayıcısı. Bu işlemi bildirmeli ve kimlik bilgileriniz tarafından izin verilmiş olmalıdır. |
messages gerekli | dizi | Rol/içerik ile 1–256 konuşma mesajı. Seçilen ses modelinin desteklediği içerik modlarını kullanın. |
modalities | dizi | Metin ve ses değerlerinden bir veya iki benzersiz değer; ses gereklidir. Varsayılan olarak ses seçilir. Bu senkron uç nokta akışı kabul etmez. |
audio | nesne | İsteğe bağlı çıkış seçenekleri: yalnızca ses ve format. Format, model desteğine bağlı olarak mp3, wav, flac, pcm16 veya pcm24'tür. Ham PCM, süre tarifeleriyle uyumlu değildir. |
temperature | numara | İsteğe bağlı model destekli üretim sıcaklığı. |
top_p | numara | İsteğe bağlı model destekli çekirdek örnekleme değeri. |
max_tokens | tam sayı | İsteğe bağlı çıkış-token sınırı, 1–262144. max_completion_tokens ile birleştirmeyin. |
max_completion_tokens | tam sayı | İsteğe bağlı çıkış-token sınırı, 1–262144. max_tokens ile birleştirmeyin. |
provider | nesne | İsteğe bağlı sağlayıcı yönlendirme tercihleri. Kabul edilen sağlayıcı etiketleri için provider.only kullanın, model kimliğinde bir ön ek olarak değil. Hesap ve kimlik bilgisi kısıtlamaları yine de geçerlidir. |
Sonucu okuyun#
Başarılı dönüşler, JSON ile HTTP 200 döndürür. ShareAI uç noktası, sınırlı bir JSON ses sonucu döndürür. Ses üreten taleplerle modalities:["text","audio"] ayrıca kullanabilirsiniz /api/v1/chat/completions. Talebiniz, belirtilen ses işlemine yönlendirilir. Bu senkron yanıt, dönüş öncesinde toplanır; tamamlanmamış sağlayıcı akışları başarılı faturalandırılmış sonuçlar haline gelmez. Ses çıkış formatları modeline bağlı olarak mp3, wav, flac, pcm16 veya pcm24'tür. Ham PCM, süre tarifesini destekleyemez. Üretilen tokenları sınırlamak için ya max_tokens ya da max_completion_tokens ayarlayın; her ikisini birden sağlamayın.
Faturalandırma birimleri#
Ses modelleri, ayrı metin-token ve ses-token boyutlarını, süreyi, şarkı veya talep oranlarını yayınlayabilir. Kapsayıcı token toplamları ayrık metin/ses sayaçlarına bölünür; aynı ses tokenları asla tekrar metin olarak ücretlendirilmez. Desteklenmeyen veya eksik kullanım, kodlanmış baytlardan tahmin edilmez.
Konsol'dan tam etkin model tanımlayıcısını seçin. Beyan edilen işlem ve giriş/çıkış yetenekleri bu uç noktayla eşleşmelidir; bir metin sohbet modeli başka bir işlem için değiştirilemez. Kimlik bilgileriniz, sağlayıcı ve hesap kısıtlamaları hala geçerlidir.
Fiyatlandırma ve kullanım#
Oranlar, seçilen model, sağlayıcı, birimler ve varyantlar için EUR AI kredisi olarak yayımlanır. Yalnızca aktif tarifesindeki boyutlar ücretlendirilir. Bir tahmin, yürütmeden önce kredileri ayırır; nihai ücretler ölçülen kullanıma göre hesaplanır. Fiyatlar çözünürlüğe, çıktı formatına veya bir kullanım bandına bağlı olabilir. Nihai ShareAI borçlandırmasını görmek için Konsol Kullanımı'nı kontrol edin. Yukarı akış maliyet alanları ve medya baytları, uydurulmuş token sayısına dönüştürülmez.
Erişim ve hatalar#
Kullan inference onaylanmış ağ maliyeti çıkarımı için veya monetization_gateway onaylanmış bir Builder kar marjı ve kabul edilen faturalandırma şartları için. Yalnızca kimlik doğrulama erişimi harcama yetkisi vermez. Doğrulama, model yetkilendirmesi, yetersiz kredi, oran sınırları ve yürütme hataları yapılandırılmış bir şekilde döner. error. Bir zaman aşımı veya belirsiz gönderimden sonra, başka bir potansiyel ücretli istek oluşturmadan önce Kullanımı veya video işini inceleyin.
Son güncelleme Kasım 3, 2026