Menghasilkan audio
Endpoint ShareAI mengembalikan hasil audio JSON yang terbatas.
Di halaman ini
https://api.shareai.now/api/v1/audio/generationsMenghasilkan audio
- URL Dasar
https://api.shareai.now- Otentikasi
- Kunci API Bearer atau token akses OAuth yang disetujui
- Cakupan yang diperlukan
inferenceormonetization_gateway
Endpoint ShareAI mengembalikan hasil audio JSON yang terbatas. Permintaan pembuatan audio dengan modalities:["text","audio"] juga dapat menggunakan /api/v1/chat/completions. Permintaan Anda diarahkan ke operasi audio yang telah ditentukan. Respons sinkron ini dikumpulkan sebelum dikembalikan; aliran penyedia yang tidak lengkap tidak menjadi hasil yang berhasil ditagih. Format output audio adalah mp3, wav, flac, pcm16 atau pcm24, tergantung pada model. PCM mentah tidak dapat mendukung tarif durasi. Tetapkan max_tokens atau max_completion_tokens untuk membatasi token yang dihasilkan; jangan berikan keduanya.
Sebelum Anda memulai#
Atur SHAREAI_API_KEY di server Anda dan ganti placeholder model dengan model yang saat ini diaktifkan. Jangan pernah mengekspos kunci API dalam kode browser. Model, akun, kredensial, dan penyedia semuanya harus mengizinkan operasi ini. Pengaturan opsional di bawah ini memerlukan dukungan model; batas keamanan API bukanlah janji bahwa setiap model mendukung setiap nilai.
Kirim permintaan#
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);Bidang permintaan#
| Bidang | Tipe | Makna dan batasan |
|---|---|---|
model diperlukan | string | Pengidentifikasi model publik yang diaktifkan secara tepat. Harus mendeklarasikan operasi ini dan diizinkan oleh kredensial Anda. |
messages diperlukan | array | 1–256 pesan percakapan dengan peran/konten. Gunakan hanya modalitas konten yang didukung oleh model audio yang dipilih. |
modalities | array | Satu atau dua nilai unik dari teks dan audio; audio diperlukan. Default ke audio. Endpoint sinkron ini tidak menerima aliran. |
audio | objek | Opsi output opsional: hanya suara dan format. format adalah mp3, wav, flac, pcm16 atau pcm24, tergantung pada dukungan model. PCM mentah tidak kompatibel dengan tarif durasi. |
temperature | nomor | Suhu generasi opsional yang didukung model. |
top_p | nomor | Nilai sampling nukleus opsional yang didukung model. |
max_tokens | bilangan bulat | Batas token output opsional, 1–262144. Jangan digabungkan dengan max_completion_tokens. |
max_completion_tokens | bilangan bulat | Batas token output opsional, 1–262144. Jangan digabungkan dengan max_tokens. |
provider | objek | Preferensi routing penyedia opsional. Gunakan provider.only untuk tag penyedia yang diterima, bukan awalan dalam ID model. Pembatasan akun dan kredensial tetap berlaku. |
Baca hasilnya#
Keberhasilan mengembalikan HTTP 200 dengan JSON. Endpoint ShareAI mengembalikan hasil audio JSON yang terbatas. Permintaan pembuatan audio dengan modalities:["text","audio"] juga dapat menggunakan /api/v1/chat/completions. Permintaan Anda diarahkan ke operasi audio yang telah ditentukan. Respons sinkron ini dikumpulkan sebelum dikembalikan; aliran penyedia yang tidak lengkap tidak menjadi hasil yang berhasil ditagih. Format output audio adalah mp3, wav, flac, pcm16 atau pcm24, tergantung pada model. PCM mentah tidak dapat mendukung tarif durasi. Tetapkan max_tokens atau max_completion_tokens untuk membatasi token yang dihasilkan; jangan berikan keduanya.
Unit penagihan#
Model audio dapat mempublikasikan dimensi token teks dan token audio yang terpisah, durasi, lagu, atau tarif permintaan. Total token inklusif dibagi menjadi penghitung teks/audio yang terpisah; token audio yang sama tidak pernah dikenakan biaya lagi sebagai teks. Penggunaan yang tidak didukung atau hilang tidak diestimasi dari byte yang dikodekan.
Pilih pengidentifikasi model yang diaktifkan secara tepat dari Console. Operasi yang dideklarasikan dan kemampuan input/output-nya harus sesuai dengan endpoint ini; model chat teks tidak dapat diganti untuk operasi lain. Pembatasan kredensial, penyedia, dan akun Anda tetap berlaku.
Harga dan penggunaan#
Tarif diterbitkan dalam kredit AI EUR untuk model, penyedia, unit, dan varian yang dipilih. Hanya dimensi dalam tarif aktifnya yang dikenakan biaya. Perkiraan akan memesan kredit sebelum eksekusi; biaya akhir menggunakan penggunaan yang terukur. Harga dapat bergantung pada resolusi, format output, atau rentang penggunaan. Periksa Penggunaan di Console untuk debit ShareAI akhir. Bidang biaya hulu dan byte media tidak diubah menjadi jumlah token yang diciptakan.
Akses dan kesalahan#
Gunakan inference untuk inferensi biaya jaringan yang disetujui atau monetization_gateway untuk markup Builder yang disetujui dan ketentuan penagihan yang diterima. Akses hanya identitas tidak mengizinkan pengeluaran. Validasi, otorisasi model, kredit yang tidak mencukupi, batasan tarif, dan kegagalan eksekusi mengembalikan struktur error. Setelah batas waktu atau pengiriman yang tidak pasti, periksa Penggunaan atau pekerjaan video sebelum membuat permintaan lain yang mungkin berbayar.
Terakhir diperbarui 3 November 2026