Giriş yapHemen başla
Modele dön API

Qwen 3 TTS - Text to Speech [1.7B]

API kılavuzu ve entegrasyon referansı: uç nokta, girdi alanları, fiyatlar, webhook ve hatalar.

İstek ve yanıt

POST
https://kolayzeka.com/api/models/qwen-3-tts-text-to-speech-17b/generate

Gövde: { "input": {…alanlar}, "category_id"?: sayı, "webhook_url"?: "https://…" }. Alanlar aşağıda; tanımlı olmayan bir alan 422 döner.

cURL · JSON

curl -X POST https://kolayzeka.com/api/models/qwen-3-tts-text-to-speech-17b/generate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "text": "Text",
    "language": "Auto",
    "top_k": 50,
    "top_p": 1,
    "temperature": 0.9,
    "repetition_penalty": 1.05,
    "subtalker_dosample": true,
    "subtalker_top_k": 50,
    "subtalker_top_p": 1,
    "subtalker_temperature": 0.9,
    "max_new_tokens": 200,
    "enable_safety_checker": true
  },
  "webhook_url": "https://your-server.com/hooks/kolayzeka"
}'
Üretim asenkrondur. POST, 202 ve status: "queued" döner; sonuç henüz yoktur. Sonucu GET https://kolayzeka.com/api/generations/{id} ile sorgulayın ya da webhook_url verin (aynı nesne gelir). Durumlar: queued → processing → completed | failed. estimated_seconds bu modun geçmiş ortalama süresidir (null olabilir).

1 · POST yanıtı (202)

{
  "data": {
    "id": "9d1c…-uuid",
    "model": "qwen-3-tts-text-to-speech-17b",
    "output_type": "audio",
    "source": "api",
    "status": "queued",
    "input_data": {
      "text": "Text",
      "language": "Auto",
      "top_k": 50,
      "top_p": 1,
      "temperature": 0.9,
      "repetition_penalty": 1.05,
      "subtalker_dosample": true,
      "subtalker_top_k": 50,
      "subtalker_top_p": 1,
      "subtalker_temperature": 0.9,
      "max_new_tokens": 200,
      "enable_safety_checker": true
    },
    "output_data": null,
    "thumbnail_url": null,
    "credit_cost": 80660,
    "duration": null,
    "estimated_seconds": 12,
    "error_message": null,
    "webhook_url": "https://your-server.com/hooks/kolayzeka",
    "created_at": "2026-06-29T12:00:00.000000Z",
    "updated_at": "2026-06-29T12:00:00.000000Z"
  },
  "success": true
}

2 · Tamamlandı (GET /generations/{id} veya webhook)

{
  "data": {
    "id": "9d1c…-uuid",
    "model": "qwen-3-tts-text-to-speech-17b",
    "output_type": "audio",
    "source": "api",
    "status": "completed",
    "input_data": {
      "text": "Text",
      "language": "Auto",
      "top_k": 50,
      "top_p": 1,
      "temperature": 0.9,
      "repetition_penalty": 1.05,
      "subtalker_dosample": true,
      "subtalker_top_k": 50,
      "subtalker_top_p": 1,
      "subtalker_temperature": 0.9,
      "max_new_tokens": 200,
      "enable_safety_checker": true
    },
    "output_data": {
      "result": "https://<signed-url>/output.mp3"
    },
    "thumbnail_url": "https://<signed-url>/thumb.jpg",
    "credit_cost": 80660,
    "duration": 4.52,
    "estimated_seconds": 12,
    "error_message": null,
    "webhook_url": "https://your-server.com/hooks/kolayzeka",
    "created_at": "2026-06-29T12:00:00.000000Z",
    "updated_at": "2026-06-29T12:00:05.000000Z"
  },
  "success": true
}

3 · Başarısız

{
  "data": {
    "id": "9d1c…-uuid",
    "model": "qwen-3-tts-text-to-speech-17b",
    "output_type": "audio",
    "source": "api",
    "status": "failed",
    "input_data": {
      "text": "Text",
      "language": "Auto",
      "top_k": 50,
      "top_p": 1,
      "temperature": 0.9,
      "repetition_penalty": 1.05,
      "subtalker_dosample": true,
      "subtalker_top_k": 50,
      "subtalker_top_p": 1,
      "subtalker_temperature": 0.9,
      "max_new_tokens": 200,
      "enable_safety_checker": true
    },
    "output_data": null,
    "thumbnail_url": null,
    "credit_cost": 0,
    "duration": null,
    "estimated_seconds": 12,
    "error_message": "Sağlayıcı yoğun, lütfen tekrar deneyin.",
    "webhook_url": "https://your-server.com/hooks/kolayzeka",
    "created_at": "2026-06-29T12:00:00.000000Z",
    "updated_at": "2026-06-29T12:00:00.000000Z"
  },
  "success": true
}
  • Sonuç output_data.result alanındadır (imzalı URL, süreli: kalıcı tutmak için kendi depolamanıza indirin).
  • Medya URL'leri imzalıdır ve süresi dolar; eski bir URL için işi tekrar GET edin, taze URL gelir.
  • Geçmiş: GET https://kolayzeka.com/api/generations (en yeni önce, sayfa başına 20, ?page=).

Fiyat ve teklif

Fiyat kredi cinsindendir ve seçtiğiniz seçeneklere (kalite, boyut, süre, adet…) göre değişir. Varsayılan ayarlarla bu mod ≈ 80660 kredi.

POST
https://kolayzeka.com/api/models/qwen-3-tts-text-to-speech-17b/quote

Çalıştırmadan, tam bu girdinin fiyatı. Token gerekmez; girdiyi üretimdeki gibi doğrular.

cURL

curl -X POST https://kolayzeka.com/api/models/qwen-3-tts-text-to-speech-17b/quote \
  -H "Content-Type: application/json" \
  -d '{"input":{"text":"Text","language":"Auto","top_k":50,"top_p":1,"temperature":0.9,"repetition_penalty":1.05,"subtalker_dosample":true,"subtalker_top_k":50,"subtalker_top_p":1,"subtalker_temperature":0.9,"max_new_tokens":200,"enable_safety_checker":true}}'

Yanıt

{
  "success": true,
  "data": {
    "credits": 80660,
    "basis": "per_1k_characters",
    "exact": true,
    "mode": {
      "category_id": null,
      "label": "Mod"
    }
  }
}
  • exact: false: fiyat çıktıya bağlı (ör. token, gerçek süre); teklif tipik değerle hesaplanır.
  • Kredi, istek kabul edilince teklif tutarı kadar ayrılır. İş bitince gerçek tutara göre fark düşülür ya da iade edilir; iş başarısız olursa tamamı iade edilir. Kesin tutar: sonuçtaki credit_cost.
  • Bakiye: GET https://kolayzeka.com/api/me → credit_balance. Yetmezse 402 insufficient_credits.

Girdi alanları

input içine gönderilir. Tip etiketi gönderilecek JSON değeridir (string, integer, number, boolean, url, array<url>). Aynı liste makine-okunur olarak GET https://kolayzeka.com/api/ai-models/qwen-3-tts-text-to-speech-17b yanıtında.

text
zorunlu
string

Text · The text to be converted to speech.

prompt
isteğe bağlı
string

Prompt · Optional prompt to guide the style of the generated speech. This prompt will be ignored if a speaker embedding is provided.

voice
isteğe bağlı
string

Voice · The voice to be used for speech synthesis, will be ignored if a speaker embedding is provided. Check out the **[documentation](https://github.com/QwenLM/Qwen3-TTS/tree/main?tab=readme-ov-file#custom-voice-generate)** for each voice's details and which language they primarily support.

Kabul edilen değerler:"Vivian""Serena""Uncle_Fu""Dylan""Eric""Ryan""Aiden""Ono_Anna""Sohee"

language
isteğe bağlı
string

Language · The language of the voice.

Kabul edilen değerler:"Auto""English""Chinese""Spanish""French""German""Italian""Japanese""Korean""Portuguese""Russian"

Varsayılan: "Auto" (gönderilmezse bu kullanılır)

speaker_voice_embedding_file_url
isteğe bağlı
string

Speaker Voice Embedding File Url · URL to a speaker embedding file in safetensors format, from `fal-ai/qwen-3-tts/clone-voice` endpoint. If provided, the TTS model will use the cloned voice for synthesis instead of the predefined voices.

reference_text
isteğe bağlı
string

Reference Text · Optional reference text that was used when creating the speaker embedding. Providing this can improve synthesis quality when using a cloned voice.

top_k
isteğe bağlı
number

Top K · Top-k sampling parameter.

Varsayılan: 50 (gönderilmezse bu kullanılır)

top_p
isteğe bağlı
number

Top P · Top-p sampling parameter.

Varsayılan: 1 (gönderilmezse bu kullanılır)

temperature
isteğe bağlı
number

Temperature · Sampling temperature; higher => more random.

Varsayılan: 0.9 (gönderilmezse bu kullanılır)

repetition_penalty
isteğe bağlı
number

Repetition Penalty · Penalty to reduce repeated tokens/codes.

Varsayılan: 1.05 (gönderilmezse bu kullanılır)

subtalker_dosample
isteğe bağlı
boolean

Subtalker Dosample · Sampling switch for the sub-talker.

Varsayılan: true (gönderilmezse bu kullanılır)

subtalker_top_k
isteğe bağlı
number

Subtalker Top K · Top-k for sub-talker sampling.

Varsayılan: 50 (gönderilmezse bu kullanılır)

subtalker_top_p
isteğe bağlı
number

Subtalker Top P · Top-p for sub-talker sampling.

Varsayılan: 1 (gönderilmezse bu kullanılır)

subtalker_temperature
isteğe bağlı
number

Subtalker Temperature · Temperature for sub-talker sampling.

Varsayılan: 0.9 (gönderilmezse bu kullanılır)

max_new_tokens
isteğe bağlı
number

Max New Tokens · Maximum number of new codec tokens to generate.

Varsayılan: 200 (gönderilmezse bu kullanılır)

enable_safety_checker
isteğe bağlı
boolean

Enable Safety Checker · Authorized callers may set false to request relaxed screening.

Varsayılan: true (gönderilmezse bu kullanılır)

Kimlik doğrulama

Her istekte Authorization: Bearer YOUR_API_TOKEN. Token'ı Profil sayfasında oluşturun. Katalog ve teklif (/ai-models, /quote) token istemez. Ayrıntılar: geliştirici rehberi.

Webhook

İsteğe bir webhook_url (https) ekleyin; iş bitince oraya imzalı bir POST gelir. Gövde { event, success, data }: data, durum endpoint'inin döndüğü nesnenin aynısıdır. Sorgulamaya gerek kalmaz; uzun işler (video, çok adımlı uygulamalar) için önerilir.

Gelen başlıklar

X-KolayZeka-Event: generation.completed // veya generation.failed

X-KolayZeka-Signature: sha256=<hex>

User-Agent: KolayZeka-Webhook/1.0

İmza = ham gövdenin, hesabınızın webhook imzalama anahtarı ile HMAC-SHA256'sı. Anahtarı Profil sayfasında oluşturun (bir kez gösterilir). Anahtar yoksa webhook gönderilmez.

Doğrulama · Node.js

import crypto from 'node:crypto';

// rawBody: the request body exactly as received (before JSON.parse).
const expected = 'sha256=' + crypto
  .createHmac('sha256', process.env.KOLAYZEKA_WEBHOOK_SECRET)
  .update(rawBody)
  .digest('hex');
const given = req.headers['x-kolayzeka-signature'] ?? '';

if (given.length !== expected.length ||
    !crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(given))) {
  return res.status(401).end();
}

Doğrulama · PHP / Laravel

$expected = 'sha256='.hash_hmac('sha256', $request->getContent(), config('services.kolayzeka.webhook_secret'));

abort_unless(hash_equals($expected, (string) $request->header('X-KolayZeka-Signature')), 401);
  • 2xx dönün. Diğer yanıtlar ve ağ hataları 30 sn arayla en çok 5 kez yeniden denenir.
  • Aynı iş için birden fazla gelebilir: data.id ile tekilleştirin.
  • Özel / iç ağ / bulut-metadata adresleri reddedilir (422 invalid_webhook_url).

Hatalar

Her hata aynı şekildedir: { success: false, code, error, … }. Kodunuzu code'a göre yazın; error insan için mesajdır.

HTTPcodeNe zaman
400
invalid_modeModelin şu an çalıştırılabilir bir modu yok (geçici; başka model deneyin).
401
unauthenticatedBearer token yok, geçersiz ya da iptal edilmiş.
402
insufficient_creditsBakiye yetmiyor. Yanıtta balance (bakiye) ve required (gereken) var.
403
forbiddenBu kaynağa erişim yetkiniz yok.
404
not_foundModel / uygulama / iş yok, aktif değil ya da size ait değil.
405
method_not_allowedEndpoint bu HTTP metodunu kabul etmiyor.
422
validation_failedGirdi şemaya uymuyor. errors alanı: alan → mesajlar.
422
invalid_webhook_urlwebhook_url https değil, çözümlenmiyor ya da özel / iç ağ adresi.
429
rate_limitedHız sınırı aşıldı. retry_after saniye sonra tekrar deneyin.
500
server_errorBeklenmeyen hata. Tekrar denemeden önce listeden (GET /api/generations) işin oluşup oluşmadığına bakın.

402 örneği

{
  "success": false,
  "code": "insufficient_credits",
  "error": "Yetersiz kredi. Bakiye: 40, Gerekli: 55",
  "balance": 40,
  "required": 55
}

422 örneği

{
  "success": false,
  "code": "validation_failed",
  "error": "Doğrulama başarısız oldu.",
  "errors": {
    "quality": [
      "`quality` alanı şunlardan biri olmalıdır: low, medium, high."
    ]
  }
}
Qwen 3 TTS - Text to Speech [1.7B] modeline geri dön