ShareAI Platform Docs

Ses oluştur

ShareAI uç noktası, sınırlı bir JSON ses sonucu döndürür.

Markdown olarak görüntüle
Bu sayfada
POST https://api.shareai.now/api/v1/audio/generations

Ses oluştur

Temel URL
https://api.shareai.now
Kimlik doğrulama
Bearer API anahtarı veya onaylanmış OAuth erişim jetonu
Gerekli kapsam
inference or monetization_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
}'

İstek alanları#

AlanTürAnlam ve sınırlar
model gereklimetin dizisiTam etkinleştirilmiş genel model tanımlayıcısı. Bu işlemi bildirmeli ve kimlik bilgileriniz tarafından izin verilmiş olmalıdır.
messages gereklidiziRol/içerik ile 1–256 konuşma mesajı. Seçilen ses modelinin desteklediği içerik modlarını kullanın.
modalitiesdiziMetin 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.
audionesneİ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.
temperaturenumaraİsteğe bağlı model destekli üretim sıcaklığı.
top_pnumaraİsteğe bağlı model destekli çekirdek örnekleme değeri.
max_tokenstam sayıİsteğe bağlı çıkış-token sınırı, 1–262144. max_completion_tokens ile birleştirmeyin.
max_completion_tokenstam sayıİsteğe bağlı çıkış-token sınırı, 1–262144. max_tokens ile birleştirmeyin.
providernesneİ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

ShareAI Platform Belgeleri
Tüm belgeler

Başlık veya içerik ile ara.

Bu sayfa hakkında soru sor

Bu sayfayı keşfetmek için bir asistan seçin. Ayrıca sayfayı kopyalayıp konuşmanıza yapıştırabilirsiniz.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI