Generate AI video with Codex or Claude Code

Codex and Claude Code can use the local HolyCrab CLI to request AI video from models such as Seedance 2.5 and Kling 4.0. Install the CLI, connect your HolyCrab API Key, describe the video and review the credit estimate before approving generation.

What generates the video, and what does it cost?

  • Codex or Claude Code prepares and runs the request through HolyCrab CLI. The selected video model generates the clip through your HolyCrab account; installing the CLI alone does not generate a video.
  • Paid generation uses HolyCrab credits. Review model pricing and the estimate for your exact settings before approving. Image and audio tasks follow the same estimate-and-confirm workflow.
  • Start with CLI installation and account setup. To create without a coding Agent, follow the browser video guide.

Choose by the result you need

Name a model if you have a preference. Otherwise describe the result and let Codex check the installed model directory and your account access.

ModelWhat you can requestWhat to specify
Kling 4.0Video from text, images or video references; frame and audio references are also supported.The desired duration, 720p or 1080p, reference roles and sound.
Kling 4.0 Flash720p video from text, image/video references or a first frame.It does not accept audio references, middle frames or a last frame. Use another supported model when these are required.
MiniMax H3 Image / HighspeedGenerate images or edit reference images. These are separate from MiniMax H3 video models.Describe the changes, aspect ratio or dimensions, image count and JPEG, PNG or WebP format.
Seedance 2.5 Flash480p or 720p video, 4–30 seconds; reference, first/last frames, editing or extension.Describe references and sound. Flash does not support drafts or draft conversion.
Seedream 5.5Generate or edit one image at 1K, 1.5K or 2K.Choose dimensions and PNG (default) or JPEG. Use up to 10 reference images.
Seedance 2.5Generate up to 4K video, or review a 480p draft before creating its 1080p or 4K final.Explicitly ask for a draft if you want to use draft-to-final conversion.

Choose sound for Kling video

  • Ask for newly generated sound, the original sound from a reference video, or an audio reference. Generating sound and supplying an audio reference are different choices.
  • To keep original sound, provide a video reference. You cannot combine original-video sound with a voice reference in the same request.
  • Kling 4.0 Flash does not accept audio references; it can still generate sound. Tell Codex the sound you want and let it check the supported settings.

Copy one of these requests into Codex

ImageEstimate image editsUse HolyCrab and MiniMax H3 Image to edit my product photo: keep the product and label, replace the background with wet black stone, and return two square PNG images. Check the references and estimate the total credits first. Do not generate yet.
VideoEstimate a videoUse HolyCrab and Kling 4.0 for an 8-second, 16:9, 1080p rainy-night street video with a slow push-in. I want generated sound, without an audio reference. Check whether the settings are supported and estimate credits first. Do not generate yet.
AudioEstimate audioUse HolyCrab to create a calm 20-second English voiceover for a travel film. Recommend suitable settings and estimate credits first. Do not generate yet.

What Codex should do

1. Check what is supported

Codex first reads the installed HolyCrab capability list instead of guessing model names or settings.

Codex conversation with a first HolyCrab video request

A first request describes the result and explicitly asks for an estimate only.

2. Estimate credits

Codex shows the model, duration or image size, image count, format and estimated credits before submitting a paid generation. For reference-based requests, explain what each file should contribute and what sound you want.

Codex showing a HolyCrab credit estimate and waiting for confirmation

Review the estimate. No paid task should be created at this point.

3. Wait for your decision

Reply with changes, say cancel, or clearly approve this exact request. Silence is not approval.

4. Create one task

After approval, Codex submits once and keeps the returned Task ID—the receipt number for this generation.

5. Wait for the same task

Codex checks that Task ID until it succeeds or fails, then helps download the result.

Three safe replies

ChangeRevise itChange it to 9:16 and 5 seconds, then estimate again. Do not generate.
CancelStop hereCancel this request. Do not create a task.
ApproveCreate this oneI confirm this exact model, setting, and estimated credit cost. Create one task only.

Preview a draft, then create its final

A Seedance 2.5 draft and its final are separate paid tasks. A normal 480p video is not automatically a draft.

1. Request and approve the draft

Tell Codex: “Use HolyCrab and Seedance 2.5 for a 4-second, 16:9, 480p draft of a rainy street. Estimate the credits first and wait for my approval. After generation, download the draft; do not create the final yet.”

2. Watch the draft

Review the downloaded result and keep its Task ID. If the content needs to change, request a new draft and review its estimate.

3. Review the final quote

Tell Codex: “Convert that draft to a 4K final (or choose 1080p). Show the additional credit estimate and wait for my approval.” Give it the original draft Task ID if you resumed in a new conversation; you do not need to upload the same references again.

4. Approve and download the final

Approve the displayed final quote when you are ready. If the price changes before submission, review the new quote first. Codex should track and download the final. Reuse a final that is still processing or already succeeded only when its resolution matches your request; a different or unknown resolution stops conversion and preserves the existing task. Each draft has one final; if it failed, check the reason and draft validity before reviewing a new quote.

I want to inspect the CLI myself

Show optional terminal commands

These are optional checks. Most beginners can keep using Codex instead.

holycrab models list
holycrab credits balance
holycrab tasks list

If it did not work

  • If Codex cannot find HolyCrab, start a new Codex task after installation, or use troubleshooting to check the local connection.
  • If the response skips the estimate, repeat: Estimate credits first. Do not generate yet.
  • If the connection drops after approval, ask Codex to check recent tasks. Do not approve the same paid request again yet.