ஆடியோ உருவாக்கவும்
ShareAI முடுக்கம் ஒரு வரையறுக்கப்பட்ட JSON ஆடியோ முடிவை திருப்புகிறது.
இந்த பக்கத்தில்
https://api.shareai.now/api/v1/audio/generationsஆடியோ உருவாக்கவும்
- அடிப்படை URL
https://api.shareai.now- அங்கீகாரம்
- Bearer API முக்கியம் அல்லது அங்கீகரிக்கப்பட்ட OAuth அணுகல் டோக்கன்
- தேவையான அளவுரு
inferenceormonetization_gateway
ShareAI முடுக்கம் ஒரு வரையறுக்கப்பட்ட JSON ஒலி முடிவை திருப்புகிறது. ஒலி உருவாக்கும் கோரிக்கைகள் modalities:["text","audio"] பயன்படுத்தவும் /api/v1/chat/completions. உங்கள் கோரிக்கை அறிவிக்கப்பட்ட ஒலி செயல்பாட்டிற்கு வழிமாற்றப்படுகிறது. இந்த ஒத்திசைவு பதில் திருப்புவதற்கு முன் சேகரிக்கப்படுகிறது; முழுமையற்ற வழங்குநர் ஸ்ட்ரீம்கள் வெற்றிகரமாக கட்டண முடிவுகளாக மாறாது. ஒலி வெளியீட்டு வடிவங்கள் mp3, wav, flac, pcm16 அல்லது pcm24, மாடலுக்கு உட்பட்டவை. Raw PCM ஒரு கால அளவீட்டு கட்டணத்தை ஆதரிக்க முடியாது. உருவாக்கப்பட்ட டோக்கன்களை வரையறுக்க max_tokens அல்லது max_completion_tokens ஐ அமைக்கவும்; இரண்டையும் வழங்க வேண்டாம்.
நீங்கள் தொடங்குவதற்கு முன்#
SHAREAI_API_KEY ஐ உங்கள் சர்வரில் அமைக்கவும் மற்றும் மாடல் placeholder ஐ தற்போதைய செயல்பாட்டில் உள்ள மாடலுடன் மாற்றவும். API விசையை உலாவி குறியீட்டில் ஒருபோதும் வெளிப்படுத்த வேண்டாம். மாடல், கணக்கு, சான்று மற்றும் வழங்குநர் இந்த செயல்பாட்டை அனுமதிக்க வேண்டும். கீழே உள்ள விருப்ப அமைப்புகள் மாடல் ஆதரவை தேவைப்படும்; API பாதுகாப்பு வரம்புகள் ஒவ்வொரு மாடலும் ஒவ்வொரு மதிப்பையும் ஆதரிக்கிறது என்ற வாக்குறுதியல்ல.
ஒரு கோரிக்கையை அனுப்பவும்#
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);கோரிக்கை புலங்கள்#
| புலம் | வகை | பொருள் மற்றும் வரம்புகள் |
|---|---|---|
model தேவை | string | சரியான செயல்படுத்தப்பட்ட பொது மாடல் அடையாளம். இந்த செயல்பாட்டை அறிவிக்க வேண்டும் மற்றும் உங்கள் சான்றிதழால் அனுமதிக்கப்பட வேண்டும். |
messages தேவை | வரிசை | 1–256 உரையாடல் செய்திகள் பங்கு/உள்ளடக்கத்துடன். தேர்ந்தெடுக்கப்பட்ட ஒலி மாடல் ஆதரிக்கும் உள்ளடக்க முறைகளை மட்டுமே பயன்படுத்தவும். |
modalities | வரிசை | உரை மற்றும் ஒலி ஆகியவற்றில் இருந்து ஒரு அல்லது இரண்டு தனித்துவமான மதிப்புகள்; ஒலி தேவை. இயல்பாக ஒலி. இந்த ஒத்திசைவு முடுக்கம் ஸ்ட்ரீம் ஏற்காது. |
audio | object | விருப்பமான வெளியீட்டு விருப்பங்கள்: குரல் மற்றும் வடிவம் மட்டும். வடிவம் mp3, wav, flac, pcm16 அல்லது pcm24, மாடல் ஆதரவைப் பொறுத்தது. Raw PCM கால அளவீட்டு கட்டணங்களுக்கு பொருந்தாது. |
temperature | எண் | விருப்பமான மாடல் ஆதரவு உருவாக்க வெப்பநிலை. |
top_p | எண் | விருப்பமான மாடல் ஆதரவு நியூக்ளியஸ் சாம்பிளிங் மதிப்பு. |
max_tokens | முழு எண் | விருப்பமான வெளியீட்டு-டோக்கன் வரையறை, 1–262144. max_completion_tokens உடன் இணைக்க வேண்டாம். |
max_completion_tokens | முழு எண் | விருப்பமான வெளியீட்டு-டோக்கன் வரையறை, 1–262144. max_tokens உடன் இணைக்க வேண்டாம். |
provider | object | விருப்ப வழங்குநர் வழிமாற்று முன்னுரிமைகள். வழங்குநர்.only ஐ ஏற்றுக்கொள்ளப்பட்ட வழங்குநர் குறிச்சொற்களுக்கு பயன்படுத்தவும், மாடல் ID இல் முன்னொட்டாக அல்ல. கணக்கு மற்றும் சான்றிதழ் கட்டுப்பாடுகள் இன்னும் பொருந்தும். |
முடிவைப் படிக்கவும்#
வெற்றிகரமானது HTTP 200 ஐ JSON உடன் திருப்புகிறது. ShareAI முடுக்கம் ஒரு வரையறுக்கப்பட்ட JSON ஒலி முடிவை திருப்புகிறது. ஒலி உருவாக்கும் கோரிக்கைகள் modalities:["text","audio"] பயன்படுத்தவும் /api/v1/chat/completions. உங்கள் கோரிக்கை அறிவிக்கப்பட்ட ஒலி செயல்பாட்டிற்கு வழிமாற்றப்படுகிறது. இந்த ஒத்திசைவு பதில் திருப்புவதற்கு முன் சேகரிக்கப்படுகிறது; முழுமையற்ற வழங்குநர் ஸ்ட்ரீம்கள் வெற்றிகரமாக கட்டண முடிவுகளாக மாறாது. ஒலி வெளியீட்டு வடிவங்கள் mp3, wav, flac, pcm16 அல்லது pcm24, மாடலுக்கு உட்பட்டவை. Raw PCM ஒரு கால அளவீட்டு கட்டணத்தை ஆதரிக்க முடியாது. உருவாக்கப்பட்ட டோக்கன்களை வரையறுக்க max_tokens அல்லது max_completion_tokens ஐ அமைக்கவும்; இரண்டையும் வழங்க வேண்டாம்.
கட்டண அலகுகள்#
ஒலி மாடல்கள் தனித்த உரை-டோக்கன் மற்றும் ஒலி-டோக்கன் பரிமாணங்கள், காலம், பாடல் அல்லது கோரிக்கை விகிதங்களை வெளியிட முடியும். உள்ளடக்கிய டோக்கன் மொத்தங்கள் தனித்த உரை/ஒலி கவுண்டர்களாகப் பிரிக்கப்படும்; அதே ஒலி டோக்கன்கள் ஒருபோதும் மீண்டும் உரையாக கட்டணமாக மாறாது. ஆதரிக்கப்படாத அல்லது காணாமல் போன பயன்பாடு குறியாக்கப்பட்ட பைட்களில் இருந்து மதிப்பீடு செய்யப்படாது.
Console இல் இருந்து சரியான செயல்பாட்டில் உள்ள மாடல் அடையாளத்தைத் தேர்ந்தெடுக்கவும். அதன் அறிவிக்கப்பட்ட செயல்பாடு மற்றும் உள்ளீடு/வெளியீட்டு திறன்கள் இந்த இறுதிப்புள்ளியுடன் பொருந்த வேண்டும்; ஒரு உரை உரையாடல் மாடலை மற்றொரு செயல்பாட்டிற்கு மாற்ற முடியாது. உங்கள் சான்று, வழங்குநர் மற்றும் கணக்கு கட்டுப்பாடுகள் இன்னும் பொருந்தும்.
விலை மற்றும் பயன்பாடு#
தேர்வுசெய்யப்பட்ட மாடல், வழங்குநர், அலகுகள் மற்றும் மாறுபாடுகளுக்கான விகிதங்கள் EUR AI கிரெடிட்களில் வெளியிடப்பட்டுள்ளன. அதன் செயலில் உள்ள கட்டண அளவுகளில் உள்ள பரிமாணங்களுக்கே கட்டணம் வசூலிக்கப்படும். ஒரு மதிப்பீடு செயல்படுத்துவதற்கு முன் கிரெடிட்களை முன்பதிவு செய்கிறது; இறுதி கட்டணங்கள் அளிக்கப்பட்ட பயன்பாட்டை பயன்படுத்துகின்றன. விலைகள் தீர்மானம், வெளியீட்டு வடிவம் அல்லது பயன்பாட்டு வரம்பின் அடிப்படையில் மாறக்கூடும். இறுதி ShareAI டெபிட் விவரங்களை Console Usage-ல் சரிபார்க்கவும். மேல்நிலை செலவுகள் மற்றும் மீடியா பைட்கள் கண்டுபிடிக்கப்பட்ட டோக்கன் எண்ணிக்கைகளாக மாற்றப்படுவதில்லை.
அணுகல் மற்றும் பிழைகள்#
பயன்படுத்தவும் inference அங்கீகரிக்கப்பட்ட நெட்வொர்க்-செலவு inference க்காக அல்லது monetization_gateway அங்கீகரிக்கப்பட்ட Builder மார்க்அப் மற்றும் ஏற்றுக்கொள்ளப்பட்ட கட்டண விதிமுறைகளுக்காக. அடையாளம் மட்டும் அணுகல் செலவுகளை அங்கீகரிக்காது. சரிபார்ப்பு, மாடல் அங்கீகாரம், போதுமான கிரெடிட்கள், விகித வரம்புகள் மற்றும் செயல்பாட்டு தோல்விகள் ஒரு கட்டமைக்கப்பட்ட error. Timeout அல்லது உறுதிப்படுத்தப்படாத சமர்ப்பிப்பு பிறகு, Usage அல்லது வீடியோ வேலைகளை ஆய்வு செய்து, மற்றொரு செலவான கோரிக்கையை உருவாக்குவதற்கு முன்.
கடைசியாக புதுப்பிக்கப்பட்டது நவம்பர் 3, 2026