Cast
Video's en podcasts gemaakt van je eigen bestanden, contacten en chats.
Cast heeft vandaag geen openbare API-methoden. Elke methode van Cast heeft de vlag private, dus geen enkele API-sleutel kan er een aanroepen, ook geen sleutel met volledige toegang. De methoden hieronder zijn wat de schermen van Cast aanroepen vanuit een ingelogde dashboardsessie. Ze staan er zodat je weet wat de schermen doen, niet als iets om vanuit je eigen code aan te roepen.
Een video of een podcast maak je in het dashboard: vanaf de eigen pagina van Cast, of door Cast op een contact, een contactgroep, een AI-chat of een kennisbank te slepen voor een snelle video. Van buitenaf is alleen het afgeronde bestand bereikbaar:
- Een afgerond bestand is een gewoon bestand in je Drive, in de map die je in de instellingen van Cast hebt gekozen, dus alles wat Drive voor bestanden biedt, werkt erop.
Elke methode werkt namens de eigenaar van de werkruimte en antwoordt met code 1 als het lukt. Een weigering antwoordt met een negatieve code en legt in data uit waarom. Elke methode accepteert een optionele workspace_id, om te werken in een werkruimte van jou die niet je hoofdwerkruimte is, en elke methode vereist een sessie met gebruikersclearance.
De stukken
Een video of een podcast is een stuk: één document met een id dat cst_ is, gevolgd door 16 hexadecimale tekens. De scènes ervan heten sc_ gevolgd door 8 hexadecimale tekens.
get_caststoont de video's en podcasts van de werkruimte, de nieuwste eerst. Bij de lijst krijg je het abonnement en de limieten ervan, de builds van deze maand, de opgeslagen standaardwaarden, of deze server kan bouwen en een gebruikelijke creditprijs voor elke stap.get_castleest één stuk met de brief, de items, het storyboard en de status. Alsframesoptruestaat, krijgt elke scène ook de afbeelding van het eerste beeld mee als data-URL.get_cast_frameleest de afbeelding van één scène (cast_id,scene_id) als data-URL.save_castmaakt een stuk aan of wijzigt er een. Het accepteertcast_id(leeg maakt een nieuw stuk),title(één regel, maximaal 120 tekens),brief(soort, doel, beschrijving, taal, stem, hoofdpersoon, lengte, formaat, uiterlijk en opties; sleutels die het niet kent worden weggelaten.voice_language, een taalcode van het dashboard, is de taal waarin de stemmen worden benoemd zolanglanguageopautostaat: de gastheren van een podcast spreken elkaar met die namen aan. Het dashboard zet die op zijn eigen taal als het een stuk maakt),sources(maximaal 20 items) encopy_of, waarmee een nieuw concept begint vanuit de brief, de items en het storyboard van een ander stuk. Het wordt geweigerd zolang een script of een build aan het stuk werkt.delete_castverwijdert een stuk en zijn beelden. Het bestand dat ervan is gebouwd, blijft in je Drive.
Een werkruimte bewaart maximaal 200 stukken. De items van een stuk zijn Drive-bestanden en -mappen, contacten, contactgroepen, AI-chats, kennisbanken, pilots, links en notities. Een connector wordt bewaard, maar kan nog niet worden gelezen.
Het script en het storyboard
read_cast_referencebekijkt een YouTube-video puur op stijl en antwoordt wat een brief ervan bewaart alsreference: het uiterlijk (kleuren, lettertype, hoeken, camera, overgangen en hoe lang ze duren, vorm van de ondertitels), het tempo (seconden per shot, sneden per minuut), het spreektempo, korte notities over hoe het is gemaakt en wat het voorstelt voor de brief (soort, doel, type, vorm, lengte). Het accepteerturl. Het draait als job (stappen: de video bekijken, de stijl lezen) en gebruikt AI-credits. Een stuk volgt het als de brief dereferencebevat enstyleopreferencestaat: het script wordt op dat tempo geschreven en de build snijdt met de overgangen ervan. Van de inhoud van de video wordt niets bewaard.write_cast_scriptschrijft het script op basis van de brief en de items: scènes met voor elk het eerste beeld bij een video, beurten bij een podcast. Het accepteertcast_iden een optioneleinstructionvan maximaal 600 tekens. Het draait als job (stappen: je items lezen, het script schrijven, de eerste beelden tekenen), en scripts en afbeeldingen gebruiken AI-credits.edit_cast_storyboardvoert maximaal 60 wijzigingen op volgorde uit:confirm,unconfirm,confirm_all,delete,delete_all,moveenset(de woorden van een scène, het bijschrift in beeld, de kop, het cijfer, de opsommingstekens, het citaat en de indeling van een kaart, en welke gastheer een beurt zegt). Een wijziging die niet goed is opgebouwd, weigert de hele aanroep. Het antwoordt met de beelden die het opnieuw heeft getekend.redo_cast_scenedoet één scène opnieuw. Demodeisrewrite,picture(een nieuwe afbeelding, de woorden blijven),insert(een nieuwe scène opposition, geteld vanaf 0) ofkind(wijzig wat de scène toont:title,card,picture,stock,screenshot,presenterofpodcast).instructionis maximaal 600 tekens. Het draait als job, en afbeeldingen en tekst gebruiken AI-credits.
Bouwen en publiceren
build_castbouwt het bestand uit het bevestigde storyboard en slaat het op in de Drive. Een scène die niet is bevestigd weigert het, tenzijconfirm_alloptruestaat. Het draait als job (stappen: de stem opnemen, de afbeeldingen voorbereiden, de scènes samenvoegen, het geluid mixen, opslaan in je Drive). Stemmen en afbeeldingen gebruiken AI-credits, en een build die slaagt telt mee voor de maand.stop_cast_buildstopt de build die aan een stuk werkt.publish_castdeelt een gebouwd stuk.wayislink, waarmee de link wordt aangezet (of uit, metoffoptrue), ofemail, waarmee de link wordt verstuurd naar maximaal 10 adressen into, met een optioneelmessagevan maximaal 1000 tekens. Iedereen met de link kan kijken of luisteren totdat het bestand wordt verwijderd.quick_castmaakt een snelle infographic-video over een contact, een contactgroep, een AI-chat of een kennisbank:target_kind(contact,contact_group,chatofknowledge_base),target_id, een optioneletarget_namevoor de titel en een optionelelanguagedie wordt gebruikt als de instellingen Auto zeggen. Het gebruikt de standaardwaarden die in de instellingen zijn opgeslagen. Het draait als job (stappen: het item lezen, het script schrijven, de beelden tekenen, de video bouwen).
Eén server bouwt voor iedereen één stuk tegelijk. Een werkruimte heeft maximaal twee plaatsen in die rij, één die bouwt en één die wacht, en een derde wordt geweigerd.
Instellingen en abonnementen
save_cast_settingsslaat de standaardwaarden op voor nieuwe stukken en voor snelle video's:language(autoof een taalcode van het dashboard),voiceengender,voice2engender2voor de tweede gastheer,character,seconds,size(9:16,1:1,4:5of16:9),style,captions,music,quick_buildenfolder. Alleen de sleutels die je meestuurt, veranderen.get_cast_plansleest de abonnementen met hun prijzen, functies en rechten, het abonnement waarop dit account zit, of Cast aanstaat en de builds die deze maand zijn gebruikt.cast_set_planzet Cast aan, wijzigt het abonnement (plan_idiscast_free,cast_starter,cast_growthofcast_business) of zet het uit (een legeplan_id, ofdeactivateoptrue). Uitzetten bewaart elke video en podcast. Beide abonnementsmethoden accepteren een optionelebilling_workspace_id, die pas telt zodra de abonnementen van Cast per werkruimte worden bijgehouden.
Wat wordt geweigerd
Het dashboard zegt elk van deze met woorden naast het bedieningselement. In het antwoord van de methode zijn het een negatieve code met een zin in data:
- Alleen de eigenaar van een werkruimte kan er video's en podcasts in maken. Een openbare Assistant-chat kan dat niet.
- Cast staat uit voor het account, of het aantal builds van het abonnement in de maand is op (een build wordt geweigerd, een script niet).
- De lengte of het aantal scènes ligt boven wat het abonnement toestaat.
- Er wordt aan het stuk gewerkt. Een script of een build is ermee bezig, dus het kan niet worden opgeslagen of bewerkt totdat dat klaar is of wordt gestopt.
- Er zijn te weinig AI-credits om een script, een afbeelding of een stem te betalen.