Generating Videos

​

Body

• apiKey (string): API key generated via the Kodisc Dev dashboard.
• prompt (string): Prompt used to generate the video.

• aspectRatio (string?): Aspect ratio of generation. Must be 16:9 or 9:16 (mobile)
• colors (string?): A JSON object stringified. Colors must be hex code. All color fields:
  • “primary”
  • “secondary”
  • “background”
  • “text”
• fps (string?): Number representing the framerate of the video
• voiceover (boolean?): Whether or not to add AI voiceovers to the clip.
• voice (string?): Voice that the AI voiceover uses if enabled. Voiceovers are provided by Azure and thus any voice from this list can be used (ex. en-US-AriaNeural).

​

Response

• success (boolean): Whether the request succeeded or not. It can fail due to multiple factors including invalid API key, insufficient credits, failed video generation (rare, also will not charge API key for a failed request)
• error (string?): Error message if success is false.
• video (string?): If the request succeeded, this is the URL of the generated video on Kodisc’s CDN.
• code (string?): If the request succeeded, this is the code used to generate the video.

​

Example

const body = new FormData();
body.append("apiKey", "kodisc_xxxx");
body.append("prompt", "Draw the function x^2");

const response = await fetch("https://api.kodisc.com/generate/video", {
  method: "POST",
  body,
});
const json = (await response.json()) as {
  success: boolean;
  error?: string;
  video?: string;
  code?: string;
};