வீடியோக்களை உருவாக்கவும்
சமர்ப்பிப்பு HTTP 202 ஐ ShareAI வேலை ID மற்றும் polling URL உடன் திருப்புகிறது.
இந்த பக்கத்தில்
https://api.shareai.now/api/v1/videosவீடியோக்களை உருவாக்கவும்
- அடிப்படை URL
https://api.shareai.now- அங்கீகாரம்
- Bearer API முக்கியம் அல்லது அங்கீகரிக்கப்பட்ட OAuth அணுகல் டோக்கன்
- தேவையான அளவுரு
inferenceormonetization_gateway
சமர்ப்பிப்பு HTTP 202 ஐ ShareAI வேலை ID மற்றும் polling URL உடன் திருப்புகிறது. ஒரே கோரிக்கைக்கு Idempotency-Key மீண்டும் முயற்சிக்க ஒரு நிலையான தலைப்பை அனுப்பவும். அதே விசையை வேறுபட்ட உள்ளீட்டுடன் மீண்டும் பயன்படுத்துவது நிராகரிக்கப்படும். Poll GET /api/v1/videos/{id} அதே மூல சான்றுடன். நிலைகள் காத்திருப்பு, நிலுவையில், செயல்பாட்டில், இறுதியாக, முடிக்கப்பட்டது, தோல்வி மற்றும் மதிப்பாய்வு தேவை ஆகியவற்றை உள்ளடக்கியவை. மதிப்பாய்வு தேவைப்படும் முடிவு குழு சமரசத்தை தேவைப்படும்; polling ஒருபோதும் மற்றொரு தலைமுறையை தொடங்காது.
நீங்கள் தொடங்குவதற்கு முன்#
SHAREAI_API_KEY ஐ உங்கள் சர்வரில் அமைக்கவும் மற்றும் மாடல் placeholder ஐ தற்போதைய செயல்பாட்டில் உள்ள மாடலுடன் மாற்றவும். API விசையை உலாவி குறியீட்டில் ஒருபோதும் வெளிப்படுத்த வேண்டாம். மாடல், கணக்கு, சான்று மற்றும் வழங்குநர் இந்த செயல்பாட்டை அனுமதிக்க வேண்டும். கீழே உள்ள விருப்ப அமைப்புகள் மாடல் ஆதரவை தேவைப்படும்; API பாதுகாப்பு வரம்புகள் ஒவ்வொரு மாடலும் ஒவ்வொரு மதிப்பையும் ஆதரிக்கிறது என்ற வாக்குறுதியல்ல.
ஒரு கோரிக்கையை அனுப்பவும்#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/videos" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
--data '{
"model": "YOUR_ENABLED_VIDEOS_MODEL",
"prompt": "A slow camera move through a quiet forest.",
"duration": 8
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_VIDEOS_MODEL',
'prompt': 'A slow camera move through a quiet forest.',
'duration': 8}
headers = {'Content-Type': 'application/json', 'Idempotency-Key': 'YOUR_UNIQUE_REQUEST_ID'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/videos', 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/videos", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json", "Idempotency-Key": "YOUR_UNIQUE_REQUEST_ID"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_VIDEOS_MODEL",
"prompt": "A slow camera move through a quiet forest.",
"duration": 8
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);கோரிக்கை புலங்கள்#
| புலம் | வகை | பொருள் மற்றும் வரம்புகள் |
|---|---|---|
model தேவை | string | சரியான செயல்படுத்தப்பட்ட பொது மாடல் அடையாளம். இந்த செயல்பாட்டை அறிவிக்க வேண்டும் மற்றும் உங்கள் சான்றிதழால் அனுமதிக்கப்பட வேண்டும். |
prompt தேவை | string | காலியாக இல்லாத தலைமுறை prompt, அதிகபட்சம் 256 KiB UTF-8 உரை. |
duration | முழு எண் | விருப்பமாக கோரப்பட்ட வீடியோ கால அளவு விநாடிகளில், 1–600, தேர்ந்தெடுக்கப்பட்ட மாடலால் மேலும் கட்டுப்படுத்தப்படும். உண்மையான திருப்பப்பட்ட கால அளவுகள் கால அளவுக்கான கட்டணத்தை நிர்ணயிக்கும். |
resolution | string | மாடல் ஆதரவு தீர்மான தேர்வாளர், அதிகபட்சம் 100 எழுத்துகள்; வெளியிடப்பட்ட கட்டண மாறுபாட்டுடன் பொருந்த வேண்டும். |
aspect_ratio | string | மாடல் ஆதரவு கோண விகித தேர்வாளர், அதிகபட்சம் 100 எழுத்துகள். |
size | string | மாடல் ஆதரவு வெளியீட்டு அளவு, அதிகபட்சம் 100 எழுத்துகள், உதாரணமாக 1024×1024. ஒவ்வொரு மாடலும் இந்த விருப்பத்தை ஆதரிக்காது. |
generate_audio | பூலியன் | விருப்பமாக வீடியோ சவுண்ட்டிராக் தேர்வாளர். மாடல் ஆதரவு மற்றும் பொருந்தும் கட்டண மாறுபாடு தேவைப்படும். |
seed | முழு எண் | விருப்பமாக மாடல் ஆதரவு விதை. வீடியோ ஒரு எதிர்மறை அல்லாத முழு எண்ணை தேவைப்படும்; மீளத்திறன் செயல்படுத்துபவரின் மீது निर्भर. |
frame_images | வரிசை | அதிகபட்சம் இரண்டு image_url பகுதிகள், ஒவ்வொன்றும் frame_type first_frame அல்லது last_frame உடன், நகல்கள் இல்லாமல். frame_images மற்றும் input_references ஐ இணைக்க வேண்டாம். |
input_references | வரிசை | அதிகபட்சம் 16 வகைப்படுத்தப்பட்ட image_url பகுதிகள் image_url.url HTTPS URL அல்லது ஆதரிக்கப்படும் image data URL ஆக அமைக்க வேண்டும். மாடல் ஆதரவு தேவைப்படும். |
provider | object | விருப்ப வழங்குநர் வழிமாற்று முன்னுரிமைகள். வழங்குநர்.only ஐ ஏற்றுக்கொள்ளப்பட்ட வழங்குநர் குறிச்சொற்களுக்கு பயன்படுத்தவும், மாடல் ID இல் முன்னொட்டாக அல்ல. கணக்கு மற்றும் சான்றிதழ் கட்டுப்பாடுகள் இன்னும் பொருந்தும். |
allow_temporary_retention | பூலியன் | வீடியோ மட்டும். Explicit true தற்காலிக மேல்நிலை முடிவுகளை சேமிக்க அனுமதிக்கிறது, அவசியமான வழிகளில் தேவைப்படும். Omitted/false அந்த வழிகளை கிடைக்காமல் வைத்திருக்கிறது. provider.zdr:true உடன் முரண்படுகிறது; பிற செயல்பாடுகள் கட்டாய ZDR ஐ சேமிக்கின்றன. |
முடிவைப் படிக்கவும்#
வெற்றி JSON உடன் HTTP 202 ஐ திருப்புகிறது. சமர்ப்பிப்பு HTTP 202 ஐ ShareAI வேலை ID மற்றும் polling URL உடன் திருப்புகிறது. ஒரே கோரிக்கைக்கு Idempotency-Key மீண்டும் முயற்சிக்க ஒரு நிலையான தலைப்பை அனுப்பவும். அதே விசையை வேறுபட்ட உள்ளீட்டுடன் மீண்டும் பயன்படுத்துவது நிராகரிக்கப்படும். Poll GET /api/v1/videos/{id} அதே மூல சான்றுடன். நிலைகள் காத்திருப்பு, நிலுவையில், செயல்பாட்டில், இறுதியாக, முடிக்கப்பட்டது, தோல்வி மற்றும் மதிப்பாய்வு தேவை ஆகியவற்றை உள்ளடக்கியவை. மதிப்பாய்வு தேவைப்படும் முடிவு குழு சமரசத்தை தேவைப்படும்; polling ஒருபோதும் மற்றொரு தலைமுறையை தொடங்காது.
கட்டண அலகுகள்#
வீடியோ வழிகள் தங்கள் கட்டண அலகுகளை அறிவிக்கின்றன. ஒரு விநாடி வழி ஒவ்வொரு திருப்பப்பட்ட கோப்பின் அளவிடப்பட்ட கால அளவைப் பயன்படுத்தி தீர்மானிக்கிறது, ஒருபோதும் கோரப்பட்ட கால அளவையோ அல்லது மேல்நிலை USD செலவையோ அல்ல. கோரப்பட்ட கால அளவு 1 முதல் 600 விநாடிகளுக்கு இடையில் இருக்க வேண்டும் மற்றும் மாடலால் ஆதரிக்கப்பட வேண்டும். ஒரு பாதுகாப்பான கடன் பிடிப்பு அதிகபட்சம் நான்கு வெளியீடுகளை உள்ளடக்க முடியும்.
Console இல் இருந்து சரியான செயல்பாட்டில் உள்ள மாடல் அடையாளத்தைத் தேர்ந்தெடுக்கவும். அதன் அறிவிக்கப்பட்ட செயல்பாடு மற்றும் உள்ளீடு/வெளியீட்டு திறன்கள் இந்த இறுதிப்புள்ளியுடன் பொருந்த வேண்டும்; ஒரு உரை உரையாடல் மாடலை மற்றொரு செயல்பாட்டிற்கு மாற்ற முடியாது. உங்கள் சான்று, வழங்குநர் மற்றும் கணக்கு கட்டுப்பாடுகள் இன்னும் பொருந்தும்.
விலை மற்றும் பயன்பாடு#
தேர்வுசெய்யப்பட்ட மாடல், வழங்குநர், அலகுகள் மற்றும் மாறுபாடுகளுக்கான விகிதங்கள் EUR AI கிரெடிட்களில் வெளியிடப்பட்டுள்ளன. அதன் செயலில் உள்ள கட்டண அளவுகளில் உள்ள பரிமாணங்களுக்கே கட்டணம் வசூலிக்கப்படும். ஒரு மதிப்பீடு செயல்படுத்துவதற்கு முன் கிரெடிட்களை முன்பதிவு செய்கிறது; இறுதி கட்டணங்கள் அளிக்கப்பட்ட பயன்பாட்டை பயன்படுத்துகின்றன. விலைகள் தீர்மானம், வெளியீட்டு வடிவம் அல்லது பயன்பாட்டு வரம்பின் அடிப்படையில் மாறக்கூடும். இறுதி ShareAI டெபிட் விவரங்களை Console Usage-ல் சரிபார்க்கவும். மேல்நிலை செலவுகள் மற்றும் மீடியா பைட்கள் கண்டுபிடிக்கப்பட்ட டோக்கன் எண்ணிக்கைகளாக மாற்றப்படுவதில்லை.
அணுகல் மற்றும் பிழைகள்#
பயன்படுத்தவும் inference அங்கீகரிக்கப்பட்ட நெட்வொர்க்-செலவு inference க்காக அல்லது monetization_gateway அங்கீகரிக்கப்பட்ட Builder மார்க்அப் மற்றும் ஏற்றுக்கொள்ளப்பட்ட கட்டண விதிமுறைகளுக்காக. அடையாளம் மட்டும் அணுகல் செலவுகளை அங்கீகரிக்காது. சரிபார்ப்பு, மாடல் அங்கீகாரம், போதுமான கிரெடிட்கள், விகித வரம்புகள் மற்றும் செயல்பாட்டு தோல்விகள் ஒரு கட்டமைக்கப்பட்ட error. Timeout அல்லது உறுதிப்படுத்தப்படாத சமர்ப்பிப்பு பிறகு, Usage அல்லது வீடியோ வேலைகளை ஆய்வு செய்து, மற்றொரு செலவான கோரிக்கையை உருவாக்குவதற்கு முன்.
தற்காலிக வீடியோ சேமிப்பு#
சில வீடியோ வழிகள் உருவாக்கப்பட்ட முடிவை மீட்டெடுக்க தற்காலிக மேல்நிலை தக்கவைத்தல் தேவைப்படுகிறது. அவை உங்கள் தெளிவான allow_temporary_retention:true அந்த வீடியோ கோரிக்கையில் ஏற்றுக்கொள்ளுதல் தேவைப்படுகிறது. அதை தவிர்ப்பது அந்த வழிகளை கிடைக்காதவையாக வைத்திருக்கிறது. இந்த விதிவிலக்கு வீடியோக்கு மட்டுமே பொருந்தும் மற்றும் மற்ற செயல்பாடுகளுக்கான மாடல் பயிற்சி அல்லது தக்கவைத்தலை அனுமதிக்காது. ஒரு தெளிவான ZDR கொள்கை அமைதியாக தளர்த்தப்பட முடியாது.
JSON
{"allow_temporary_retention": true}வேலை நிலையை சரிபார்க்கவும்#
https://api.shareai.now/api/v1/videos/{id}அதன் தோற்றமளித்த அடையாளத்துடன் ஒரு வீடியோ உருவாக்கத்தை வாசிக்கவும்
- அடிப்படை URL
https://api.shareai.now- அங்கீகாரம்
- Bearer API முக்கியம் அல்லது அங்கீகரிக்கப்பட்ட OAuth அணுகல் டோக்கன்
- தேவையான அளவுரு
inferenceormonetization_gateway
JSON
{
"id": "YOUR_JOB_ID",
"object": "video",
"status": "pending",
"created_at": 1793664000,
"polling_url": "/api/v1/videos/YOUR_JOB_ID"
}மேலே உள்ள JSON நிலையான வேலை துறைகளை விளக்குகிறது, உண்மையான உருவாக்கத்தை அல்ல. அதே விசையுடன் ShareAI பாதையை Poll செய்யவும், சரிபார்ப்புகளுக்கு இடையில் காத்திருக்கவும். queued, pending, in_progress மற்றும் finalizing காத்திருக்க வேண்டும் என்று பொருள்; completed ShareAI உள்ளடக்க URLக்களுடன் தரவுகளை வெளிப்படுத்துகிறது; failed மற்றும் requires_review நிறுத்தி ஆய்வு செய்ய வேண்டும் என்று பொருள். தற்காலிக பிழைகளுக்குப் பிறகு Retry நிலையை வாசிக்கவும், ஆனால் உருவாக்கத்தை தானாகவே மீண்டும் சமர்ப்பிக்க வேண்டாம். வேறொரு அல்லது ரத்து செய்யப்பட்ட அடையாளம் வேலைகளை மீட்டெடுக்க முடியாது.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
-H "Authorization: Bearer $SHAREAI_API_KEY"முடிவை பதிவிறக்கவும்#
முடிக்கப்பட்டவுடன், ஒவ்வொரு தரவுப் பதிவும் ShareAI உள்ளடக்க URL ஐ கொண்டிருக்கும். பெறவும் GET /api/v1/videos/{id}/content?index=0 அதே தோற்றமளித்த அடையாளத்தைப் பயன்படுத்தி. இறுதிப்புள்ளி ஒரு தனித்த HTTP பைட் வரம்பை ஆதரிக்கிறது. வழங்குநர் URLகள், தனிப்பட்ட டிக்கெட்டுகள் மற்றும் வழங்குநர் அடையாளங்கள் ஒருபோதும் திருப்பி அனுப்பப்படுவதில்லை. Polling மற்றும் பதிவிறக்கம் இரண்டாவது inference கோரிக்கையை அல்லது Monetization Gateway உட்கார்வு கட்டணத்தை உருவாக்காது. முடிக்கப்பட்ட வேலை ஒரு கோப்பு பதிவிறக்கத்திற்குப் பிறகு தீர்வு உறுதிப்படுத்தப்பட்டது என்று பொருள்.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID/content?index=0" \
-H "Authorization: Bearer $SHAREAI_API_KEY" --output result.mp4விருப்பமான frame_images முதல்_frame அல்லது last_frame உடன் image_url பகுதிகளை கொண்டிருக்க வேண்டும். ஒரு கோரிக்கையில் frame images அல்லது reference images ஐ பயன்படுத்தவும், இரண்டையும் அல்ல. மாடல் கால அளவுகள், தீர்மானங்கள் மற்றும் பக்கவாட்டு விகிதங்கள் API இன் பாதுகாப்பு எல்லைகளுக்கு விட அதிகமாகக் கட்டுப்படுத்தப்படலாம். Webhooks மற்றும் சீரற்ற callback URLகள் ஆதரிக்கப்படவில்லை.
கடைசியாக புதுப்பிக்கப்பட்டது நவம்பர் 3, 2026