Pro API: rajat, virhekoodit ja hyvät käytännöt

Rajat

Jokaisella avaimella on kolme: samanaikaiset renderöinnit (oletuksena 2), lähetykset minuutissa (oletuksena 60) ja, jos olet asettanut sellaisen, päivittäinen krediittiraja.

Rajan ylittyessä vastaus on 429 ja Retry-After-otsikko sekunneissa. Hylätty kutsu ei maksa mitään. Rajoissa käytetty päivä on UTC-päivä.

Pitkät videot lisäävät kaksi omaa rajaansa: 30 otosta per sekvenssi ja 5 sekvenssiä kerrallaan per lisenssi (katso Videos).

Hahmoilla on yksi: 50 per Pro-lisenssi, sovelluksessa luodut mukaan lukien, ja hahmo, jota ei käytetä yhteen vuoteen, poistetaan (katso Characters). Sijainneilla, esineillä ja eläimillä on omat rajoituksensa, jotka lasketaan erikseen: 50 per Pro-lisenssi (10 henkilökohtaisella lisenssillä, sovelluksessa), poistetaan saman vuoden käyttämättömyyden jälkeen (katso Sijainnit, esineet, eläimet, tyylit ja asut).

Face swapilla on kaksi omaa rajaansa: enintään 20 s jakso per renderöinti ja palvelimemme valmistelee kaksi videota kerrallaan. Sen ylittyessä vastaus on 429 server_busy: yritä uudelleen Retry-After-arvon jälkeen (katso Face swap). MCP:n kautta siirtymällinen Face swap ottaa koko videon, enintään 60 s, ja palvelin käsittelee kaksi kerrallaan: sen yli työkalu pyytää yrittämään uudelleen muutaman minuutin päästä.

Oma korttimme on jaettu sovelluksen käyttäjien kanssa. Kun se on kiireinen, renderöintisi siirtyvät vuokratuille GPU:ille samaan hintaan ja saman API:n kautta, muutaman kymmenen sekunnin lisäkäynnistysajalla.

Virhekoodit

Koodi	error	Mitä se tarkoittaa ja mitä tehdä
400	prompt_required	Lisää prompt.
400	forbidden_content	Sisältösuodatin hylkäsi promptin.
400	invalid_seed	seed on oltava kokonaisluku välillä 0-4294967295.
400	image_required, inpaint_images_required	Tila vaatii image_b64 ja inpaint-tilassa myös mask_b64.
401	key_required, invalid_key	Otsikko puuttuu tai avain on tuntematon.
402	insufficient_credits	Saldo ei riitä tähän renderöintiin (cost ilmoitetaan). Vastauksessa on buy_url, lisenssisi krediittien ostosivulle. Käynnissä oleva renderöinti tai koulutus varaa hintansa kunnes se päättyy: engaged kertoo kuinka monta krediittiä on tällä hetkellä varattuna.
402	confirmation_required, payment_declined	Osto tallennetulla kortilla (POST /credits/purchase): pankkisi pyytää vahvistustasi tai hylkäsi maksun. Käytä buy_url-osoitetta, tavallista ostolinkkiä.
409	agent_not_allowed, no_saved_card, monthly_cap_reached	Osto tallennetulla kortilla: agenttisi ei saa ostaa (tilisivusi automaattinen täydennys), korttia ei ole tallennettu tai osto ylittäisi kuukausirajasi. Käytä buy_url-osoitetta.
409	topup_in_progress, purchase_in_progress	Toinen maksu tallennetulla kortilla on käynnissä: odota, että se päättyy.
400	unknown_pack	Osto tuntemattomalla paketilla tai vapaalla määrällä, joka on rajojen ulkopuolella tai ei ole kokonainen askel.
503	payment_unavailable	Maksua ei voitu vahvistaa: emme tiedä, menikö veloitus läpi. Älä yritä heti uudelleen; läpi mennyt veloitus hyvitetään.
403	key_disabled, key_revoked, key_expired	Avain on kytketty pois, peruutettu tai vanhentunut: luo uusi sovelluksessa.
403	license_revoked, license_not_pro	Lisenssi peruutettu tai tili ei ole Pro.
403	missing_scope	Avaimelta puuttuu pyydetty oikeus, joka on nimetty scope-kentässä.
403	unknown_lora	Hahmo, joka ei kuulu tilille.
404	media_unavailable	Tiedosto on poistunut: lähetä uudelleen.
404	unknown_lora	DELETE /loras/{name}-kutsussa: tilillä ei ole tiedostoa kyseisellä nimellä. Huomioi koodi: sama nimi palauttaa 403, kun renderöinti pyytää hahmoa, joka ei kuulu sinulle.
411	size_required	LoRA-lataus ilman Content-Length-otsikkoa. Sisältö on raakaa dataa, joten koko on ilmoitettava etukäteen.
413	file_too_large	LoRA ylittää 800 MB tai 90 MB yhdessä latauksessa. Lähetä se osissa. Pelkkä 413 ilman JSON-sisältöä on eri asia: pyyntö ei koskaan saavuttanut API:a, katso latausosio.
413	part_too_large	Yksi osa on suurempi kuin istunnon ilmoittama max_part_size.
404	unknown_upload_session	uploadId ei ole olemassa, istunto on hylätty (kuusi tuntia) tai hylätty osa on peruuttanut sen.
503	upload_refused, part_refused	Tallennustilaan ei saatu yhteyttä latauksen aikana: yritä uudelleen.
507	storage_full	Palvelimen tallennustila on täynnä (LoRA-tiedostot tai käynnissä olevat sekvenssit). Tiimi on saanut hälytyksen: yritä myöhemmin uudelleen.
415	invalid_safetensors	Ladattu tiedosto ei ole safetensors-muodossa.
415	incompatible_lora	LoRA on tarkoitettu toiselle arkkitehtuurille, joka on nimetty architecture-kentässä. Kuvat käyttävät vain Krea 2:ta, videot LTX 2.5:tä tai 2.3:a. Mitään ei tallenneta eikä kiintiötä kuluteta.
413	lora_quota	Tilin LoRA-tallennustila on täynnä (20 tiedostoa tai 10 Gt). Vastaus kertoo jäljellä olevan tilan; poista tiedosto tehdäksesi tilaa.
413	image_too_large	Lähde­kuva tai peite ylittää 12 Mt purettuna.
429	too_many_concurrent_renders, rate_limited, daily_cap	Raja on saavutettu, katso Retry-After.
429	daily_credit_cap	Avaimen päivittäinen krediittiraja on saavutettu (cap, spent, cost).
502	submission_failed, status_failed	Häiriö renderöintipuolella: yritä muutaman sekunnin kuluttua uudelleen.
503	license_check_failed	Tiliä ei voida tarkistaa juuri nyt: yritä minuutin kuluttua uudelleen.
400	invalid_extend_frames	Jatko, jonka extend_frames ei ole 9, 17, 25, 33, 41 tai 49, tai extend_video, jossa ei ole täsmälleen niin monta kuvaa.
400	extension_with_transition	Jatko ei voi olla myös siirtymä, paitsi consistency-arvolla enhanced: poista end_image tai pyydä parannettua johdonmukaisuutta.
400	extension_too_short	Jatkon length laskee vain uudet kuvat, ja sen on oltava vähintään 9.
404	clip_unavailable	Jatkettava klippi ei ole enää saatavilla: jatka sitä aiemmin tai lähetä sen loppu extend_video-kentässä. 502-vastauksena sen lukeminen epäonnistui: yritä uudelleen.
404	unknown_clip	Jatkettava klippi kuuluu toiselle lisenssille.
404	unknown_sequence	Sekvenssiä ei ole olemassa, se kuuluu toiselle lisenssille tai se on vanhentunut.
400	job_id_required, empty_sequence	POST /sequences/{id}/clips ilman job_id-arvoa, tai sekvenssin vienti ilman yhtään otosta.
409	not_exported_yet	GET /sequences/{id}/file ennen vientiä: kutsu ensin POST /sequences/{id}/export.
404	unknown_export	Projektikansion vienti: tuntematon renderöinti, toisen lisenssin tai yli 24 h sitten lähetetty; ZIP poistettu (45 min ensimmäisen latauksen jälkeen, enintään 2 h).
409	export_in_progress	Yksi projektikansion vienti kerrallaan lisenssiä kohden.
413	export_too_large	Projektikansio yli 2 Gt: vie otot yksi kerrallaan.
400	unknown_reference	Projektikansion vienti: exclude_references-merkintä ei osoita mihinkään viennin referenssiin (ei id:tä, nimeä eikä @mainintaa).
400	invalid_export_options	Projektikansion vienti: valinta, joka ei ole totuusarvo, exclude_references, joka ei ole tekstien luettelo, tai include_film ilman include_media-valintaa.
500	export_failed	Vienti epäonnistui (syy kentässä detail): mitään ei veloiteta, yritä uudelleen.
422	resolution_mismatch, unreadable_clip	Käsin lisätty renderöinti (POST /sequences/{id}/clips) eri resoluutiolla kuin sekvenssi, tai lukukelvoton renderöinti.
409	missing_shot	Otos ei ole vielä valmis tai se ei ole enää saatavilla (job_id nimeää sen): odota sen valmistumista ja vie sitten uudelleen.
409	sequence_exported	Sekvenssi on jo koottu.
409	audio_mismatch	Otos, jossa on ääni, hiljaisessa sekvenssissa tai päinvastoin.
413	extend_video_too_large	Lähettämäsi klipin loppu ylittää 8 Mt.
413	too_many_shots	Enintään 30 otosta per sekvenssi.
422	unreadable_tail	Klipin loppu, lähetetty tai luettu takaisin, ei ole luettava video.
422	assembly_failed	Otoksilla on eri resoluutiot tai ääniraidat vain osassa niistä.
503	ultra_unavailable	Ultra-tila on suljettu tällä hetkellä: yritä myöhemmin tai renderöi ilman quality-arvoa.
503	ultra_4k_unavailable	4K-kokoa pyydettiin Ultrassa: 4K:ta ei enää tarjota, video on enintään 1080p (1920 x 1088).
400	ultra_incompatible	Siirtymä (end_image) pyydettiin Ultrassa.
400	extension_4k	Aiemman 4K-klipin jatko: 4K:ta ei enää tarjota, eikä 4K-klippiä voi jatkaa (ultra_4k_unavailable, kun quality: "max"). Jatka enintään 1080p:n klippiä.
400	resolution_above_quality	Koko yli 1080p (1920 x 1088) ilman quality: "max"-arvoa: 1080p on yläraja kaikissa tiloissa.
400	invalid_keyframes, invalid_keyframe_time, keyframes_mode	Keyframet rajojen ulkopuolella: enemmän kuin 4, virheellinen kuva tai vahvuus; hetki klipin ulkopuolella tai kaksi keyframea alle 0,5 s:n päässä toisistaan; muu kuin Quality-tila (Ultra, Multi-Ref) tai jatko ilman consistency-arvoa enhanced.
400	invalid_consistency, consistency_mode	consistency muu kuin standard tai enhanced; parannettua johdonmukaisuutta pyydetty Ultrassa tai Multi-Refissä.
400	consistency_explicit	Prompt, jota parannettu johdonmukaisuus ei vielä renderöi, yli 20 s (15 s end_image-arvolla), jatkossa tai sekvenssissa (yksittäinen lyhyempi otos renderöityy standard-johdonmukaisuudella): lyhennä sitä tai käytä standard-arvoa.
403	consistency_licensed_only	Parannettu johdonmukaisuus on varattu lisenssinhaltijoille.
503	consistency_unavailable	Parannettu johdonmukaisuus on suljettu tällä hetkellä: yritä myöhemmin tai renderöi standard-tilassa.
409	consistency_mismatch	Otos, jonka consistency poikkeaa sekvenssin vastaavasta.
422	encoding_mismatch	Käsin lisätty renderöinti (POST /sequences/{id}/clips), jonka consistency poikkeaa jo lisättyjen otosten vastaavasta.
400	invalid_fps, fps_requires_fixed_duration, extend_fps_mismatch	Kuvataajuus (fps), jota tilalla ei ole (detail listaa saatavilla olevat); parannettu johdonmukaisuus yli 30 fps automaattisella kestolla (aseta duration_auto arvoon false ja anna length); jatko eri kuvataajuudella kuin edellinen klippi.
409	sequence_fps_mismatch	Otos, jonka kuvataajuus (fps) poikkeaa sekvenssin vastaavasta.
503	keyframes_unavailable	Keyframet ovat suljettuina tällä hetkellä: renderöi ilman keyframes-arvoa.
429	too_many_sequences	Enintään 5 sekvenssiä käynnissä per lisenssi: vie yksi tai odota että yksi vanhenee.
400	invalid_name, invalid_kind, invalid_photo_role, outfit_too_long, invalid_role	Hahmokenttä rajojen ulkopuolella (katso Characters).
400	image_too_small	Valokuva, jonka pitkä sivu on alle 1024 px.
415	unsupported_image_format, unreadable_image	Valokuva tai sijaintikuva, joka ei ole luettava JPEG, PNG tai WebP.
404	unknown_character	character_id ei ole lisenssillä tai se on poistettu (yksi vuosi käyttämättä tai poistettu sovelluksessa).
409	character_limit	Hahmoraja (max) on saavutettu: poista yksi.
409	character_busy	Sen näkymiä valmistellaan: odota kunnes status ei ole enää pending. Kutsussa POST /characters: sama luonti on vielä tallentumassa, lähetä se uudelleen muutaman sekunnin kuluttua.
409	photo_view, empty_character, single_image_sheet	Alkuperäisestä valokuvasta tullutta näkymää ei voi toistaa; tai hahmolla ei ole yhtään luettavaa näkymää (jos tallennustila estää lukemisen: 503 storage_unavailable, yritä uudelleen); tai yhtenä kuvana tuotu sheet (sellaisenaan): sen näkymiä ei tehdä uudelleen, eikä se puke uutta sheetiä (lähetä näkymä 4 tai 1).
409	app_character	instruction tai ladattu näkymä sovelluksessa tehdylle hahmolle tai character sheetille: varattu API:n kautta luoduille hahmoille ja character sheeteille.
400	instruction_too_long	instruction on yli 200 merkkiä pitkä.
400	outfit_or_views_required	Character sheet lisätty ilman outfit- ja views-kenttää: anna luotava asu tai näkymiä.
400	views_required	Character sheet lisätty asetuksella generate: false: anna vähintään yksi näkymä.
409	source_sheet_empty	Character sheet lisätty ilman koko kehon näkymää ja rintakuvaa hahmolle, jolla ei ole kumpaakaan lähtökohdaksi: lähetä toinen niistä views-kentässä.
404	unknown_sheet	Vain API:n kautta lisätyn character sheetin (sheet_origin api) voi poistaa kutsulla DELETE /characters/{id}/sheets/{sheet_id}.
404	unknown_subject	subject_id ei ole lisenssillä tai se on poistettu vuoden käyttämättömyyden jälkeen.
409	subject_limit	Kohteiden raja (max) on saavutettu: sijainnit, esineet, eläimet, tyylit ja asut lasketaan yhteen; poista yksi.
409	empty_subject	Kohde, jolla ei ole yhtään luettavaa kuvaa.
400	invalid_type, description_too_long, invalid_images	Kohdekenttä rajojen ulkopuolella (katso Sijainnit, esineet, eläimet, tyylit ja asut).
400	invalid_image	Kohdekuva, joka ei ole luettava JPEG, PNG tai WebP, jonka pitkä sivu on vähintään 512 px (index kertoo kumpi).
400	description_required, invalid_views, invalid_view, invalid_count, too_many_images, prompt_too_long, invalid_instructions	Kohteen luominen: ei description-, prompt- eikä aloituskuvaa; näkymäavain, jota tyypillä ei ole (detail antaa luettelon); count välin 1-6 ulkopuolella tai yli 6 kuvaa aloitus mukaan lukien; yli 2 000 merkin prompt; instructions tyhjä, liian pitkä tai usealle näkymälle.
409	subject_busy, subject_not_generated, view_exists, views_exist, start_image_missing, start_image_imported	Tällä kohteella on jo sarja käynnissä; kuvista luotu kohde (lisää kuvia /images-reitillä); jo tehty näkymä (uusi se); aloitus, joka pitäisi uusia, vaikka siitä lähtee näkymiä; epäonnistunut aloitus, joka on uusittava ensin; tuotu aloitus, jota ei voi uusia.
404 / 503	unknown_view, generation_unavailable	Näkymä, jota ei ole koskaan pyydetty (lisää se); kohteiden luominen ei ole juuri nyt käytettävissä palvelimella: yritä myöhemmin uudelleen.
400	multiref_characters_required, multiref_incompatible, multiref_mode, multiref_format, invalid_length	Multi-Ref rajojen ulkopuolella: 1-4 hahmoa (Ultra-tilassa 12), ei jatkoa tai siirtymää, Multi-Ref Video-sivun formaatit ja pituudet.
400	duplicate_name, invalid_strength, unknown_mention	Kaksi hahmoa samalla nimellä; strength arvojen 0-2 ulkopuolella; @Nimi promptissa ilman hahmoa (mentions listaa ne).
400	voice_requires_audio, voice_slot	Hahmon ääni (voice_b64) ilman ääntä ("audio": true); tai muulla kuin characters[0]- ja characters[1]-hahmolla (moottori tukee 2 ääntä). index kertoo kumpi.
400	invalid_voice_choice	voice muu kuin character tai original Face swapissa, tai characters[].voice muu kuin character tai generated Multi-Ref Videossa.
413	audio_too_large	Hahmon ääni ylittää 4 Mt tai 2 Mt Face swapissa. Vain ensimmäiset 5 sekuntia käytetään (Face swapissa 20): lähetä lyhyt katkelma.
415	unsupported_audio_format	Hahmon ääni ei ole luettava äänitiedosto (WAV, MP3, OGG, FLAC).
400	multiref_too_many_references, invalid_subject_type	Yhteensä yli 4 hahmoa, esinettä ja eläintä Ultra-tilan ulkopuolella; kohde väärässä kentässä (sijainti subjects-kentässä, esine location-kentässä, tyyli styles-kentän ulkopuolella, asu outfits-kentän ulkopuolella).
400	invalid_count, invalid_view, invalid_lora_pass, invalid_subject_image, invalid_size	Create an image: count 1 tai 2, view 1-5 ja mukana character sheetissä, lora_pass 0,3-0,9, kohteen image sen omien kuvien joukosta, leveys ja korkeus 256-2048.
400	character_not_ready	Create an image: hahmon valitulla näkymällä ei ole vielä kuvaa.
503	multiref_image_disabled	Create an image ei ole vielä avoinna tällä palvelimella.
400	multiref_ultra_only, multiref_too_many_images, unknown_wearer	Tyylit, asut tai liike Ultra-tilan Multi-Refin ulkopuolella; yli 30 kuvaa Ultra-tilassa; worn_by, joka ei nimeä yhtään hahmoa.
400	invalid_motion, invalid_motion_mode, unreadable_motion, motion_missing	motion ilman motion_id- ja video_b64-kenttää; muu mode kuin camera tai choreography; lukukelvoton video tai video, joka ei ole 4-30 s (input_video_out_of_limits); motion_id, jota ei koskaan ladattu (ei PUT-kutsua).
404 / 409	unknown_motion, motion_already_used	motion_id on tuntematon, jo käytetty tai yli 2 tuntia vanha: lataa video uudelleen.
413 / 503	motion_too_large, motion_not_open, motion_mode_unavailable	Yli 20 MB:n liikevideo (20 MB 480p:ksi pienennettynä); liike ei ole vielä avoinna (ultra.motion_per_second on null); mode, joka ei ole vielä avoinna.
409	extension_link_expired	extend_job_id, jota lisenssisi ei tunne, tai yli 24 tuntia vanha Ultra-otto: lataa sen alkuperäinen (POST /extensions) ja anna extend_upload_id.
400	extension_real_face	Ultrassa jatkettavaa videota ei ole renderöity Ultra-tilassa (esimerkiksi toisen tilan renderöinti), ja siinä näkyy realistiset kasvot: mitään ei veloiteta. Jatka sitä Quality-tilassa tai tee otto uudelleen Ultrassa.
400	extension_ultra_only, extension_ultra_options, invalid_extension_direction, extension_backward_sequence, extension_tail_quality_only	Ultra-jatko rajojen ulkopuolella: extend_upload_id tai backward ilman quality: "max" -arvoa (tai klipistä, joka ei ole Ultra); aloituskuva, viitteet, liike tai parannettu konsistenssi samassa pyynnössä; muu suunta kuin forward tai backward; backward sekvenssissä; extend_video Ultra-tilassa.
400	extension_too_large, unreadable_extension, extension_upload_missing	Ladattu video yli 1080p; lukukelvoton MP4 tai muu kuin 4-30 s (input_video_out_of_limits); tiedosto, jota ei koskaan ladattu (ei PUT-kutsua).
400	input_video_out_of_limits	Ultra-tilaan lähetetty video (liike, jatkettava video) rajojensa ulkopuolella, tarkistettu ennen renderöintiä, mitään ei veloiteta: limit kertoo mikä (duration: 4-30 s; total_duration: 30 s viiteäänien kanssa; count: 10; size: 200 MB; format: MP4 tai MOV; fps: 24-60; pixels: leveys × korkeus 409 600-8 295 044; aspect_ratio: 0,4-2,5), sekä value, min ja max.
404 / 409	unknown_extension_upload, extension_upload_used	extend_upload_id on tuntematon, yli 2 tuntia vanha tai jo käytetty: lataa tiedosto uudelleen.
413 / 503	extension_too_heavy, extension_not_open, extension_backward_unavailable	Yli 60 MB:n tiedosto; Ultra-jatko ei ole vielä avoinna (ultra.extend_per_second on null); taaksepäin jatkaminen ei ole vielä avoinna.
413	references_too_large	Valmistellut näkymät ylittävät renderöinnin budjetin: vähemmän hahmoja tai pienempi formaatti.
400	video_required, character_required	Face swap ilman video_b64-arvoa tai ilman character_id-arvoa.
413	video_too_large	Face swap -video ylittää 20 Mt: leikkaa tai pakkaa se ensin tai käytä MCP-työkalua tendre_face_swap, joka hyväksyy jopa 95 Mt.
415	unreadable_video	Face swap -video ei ole luettava MP4, MOV, WebM tai MKV.
400	invalid_start, invalid_duration, passage_too_short	Face swap -jakso rajojen ulkopuolella: start alle 0 tai videon lopun jälkeen; duration arvojen 0,5-20 s ulkopuolella; jakso lyhyempi kuin puoli sekuntia.
400	invalid_zone, invalid_likeness, invalid_scene, invalid_description, invalid_character_name, invalid_part	Face swap -kenttä rajojen ulkopuolella: zone muu kuin tight, normal tai wide; part muu kuin full tai head; likeness arvojen 0,5-2 ulkopuolella; scene yli 400 merkkiä; description yli 360; name yli 60.
413	face_swap_too_large	Jakso on valmistelun jälkeenkin liian raskas: anna lyhyempi duration.
429	server_busy	Palvelimemme valmistelee jo kahta Face swap -videota: yritä uudelleen Retry-After-arvon jälkeen (20 s). MCP-latauslinkki palauttaa saman koodin 503-vastauksena, kun liian monta tiedostoa odottaa: yritä muutaman minuutin kuluttua uudelleen.
503	face_swap_unavailable, face_swap_price_missing	Face swap on suljettu tai sillä ei ole hintaa tällä hetkellä: yritä myöhemmin uudelleen.
503	creation_unavailable, multiref_unavailable, storage_unavailable	Palvelu ei ole saatavilla tällä hetkellä: yritä myöhemmin uudelleen.
500	internal_error	Odottamaton häiriö palvelimen puolella: yritä uudelleen ja kerro meille jos se toistuu.

Sekunneittain laskutettava Ultra (Ultra):

Koodi	error	Mitä se tarkoittaa ja mitä tehdä
400	resolution_outside_ultra	Yli 1080p: 480p, 720p tai 1080p.
400	engine_refused	Moottori hylkää tekstin tai kuvan: syy on kentässä detail ja koodi kentässä code. Mitään ei veloiteta: muotoile uudelleen.
502	engine_unavailable	Moottori ei vastaa: yritä uudelleen muutaman minuutin päästä. Mitään ei veloiteta.
409	render_in_progress	Jo laskennassa olevan renderöinnin peruutus: se ei enää pysähdy, vaan se toimitetaan ja laskutetaan.
400	invalid_references, references_too_large, multiref_ultra_options, multiref_ultra_explicit	Multi-Ref Ultra-tilassa: viitekuva on lukukelvoton tai liian suuri (yhteensä enintään 20 Mt), tai jotakin asetusta ei tueta.
403	multiref_ultra_unavailable	Sekunneittain laskutettava Multi-Ref Ultra-tilassa ei ole vielä avoinna tälle tilille.

Virheenimät ovat tarkat merkkijonot, jotka API palauttaa. Tarkista ne, älä viestiä, joka saattaa muuttua.

Yksi vastaus ei ole virhe: Multi-Ref-renderöinti tai Face swap hahmolla, jolla on vain yksi näkymä, läpäisee, mutta warnings-kentässä on limited_likeness-varoitus ({ "code": "limited_likeness", "character_id": "...", "detail": "..." }). Samankaltaisuus on rajallinen: luo hahmon seitsemän näkymää saadaksesi uskollisen tuloksen.

Myös Multi-Ref-renderöinti Ultra-tilassa 9-12 hahmolla läpäisee, mutta many_characters-varoituksen kanssa: osa voi puuttua tai sekoittua (suositus on 8).

Hyvät käytännöt

• Pollaa 3 sekunnin välein, ei useammin. Jono on jaettu, eikä sen pommittamisesta ole hyötyä kenellekään.
• Lataa heti kun tila on completed. Tiedostoa ei arkistoida.
• Kirjoita promptit englanniksi ja kuvaa videoissa liike paikallaan olevan kuvan sijaan.
• Yksi avain per käyttötarkoitus ja päivittäinen krediittiraja jokaiselle palvelimella elävälle avaimelle. Vuotanut avain rajalla maksaa sinulle päivän, ei koko saldon.
• Käsittele 429 normaalina, ei virheenä: odota Retry-After-arvo ja jatka.
• Ennen vastausta katkeava yhteys ei maksa mitään. Jos kuvan tai videon lähetys jää ilman vastausta (välityspalvelimen aikakatkaisu, virhe 524, ohjelma pysäytetty), renderöintiä ei käynnistetä tai se peruutetaan heti, eikä mitään veloiteta: lähetä pyyntö vain uudelleen. Kuvasarjassa (count) myös jo luodut renderöinnit peruutetaan. Hahmon luonti sen sijaan jatkuu: saman pyynnön lähettäminen uudelleen palauttaa saman hahmon, eikä mitään veloiteta kahdesti (katso Characters).

Promptit kirjataan puolellamme, kuten sovelluksessakin, turvallisuussyistä.