dreamina-api

mcp
Security Audit
Warn
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 10 GitHub stars
Code Warn
  • network request — Outbound network request in images/dreamina-images.mjs
  • network request — Outbound network request in seedance-draft/dreamina-draft.mjs
  • network request — Outbound network request in seedance-video/dreamina.mjs
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Node.js and Python examples for the useapi.net Dreamina (CapCut) API: Seedance 2.5, 2.0, 2.0 Fast and 2.0 Mini video, HappyHorse 1.1 and Wan 3.0 on Canada accounts, plus Seedream 5.0, GPT Image 2.5 and Nano Banana Pro images, on your Dreamina subscription over REST. Seedance 2.5 takes real faces and runs up to 3 minutes.

README.md

Dreamina API examples (useapi.net)

Runnable examples for the Dreamina API by useapi.net, a third-party REST API for Dreamina (CapCut) by ByteDance. It uses your Dreamina subscription: Free, Basic $15, Standard $36, Advanced $79 to $320 or Ultra $520 a month in the US (as of October 2026).

It makes video with Seedance 2.5, 2.5 Flash (CA only), 2.5 Draft, 2.0, 2.0 Fast and 2.0 Mini, Seedance 1.5 Pro (US only), 1.0 Pro (CA only), 1.0 Mini (US only) and 1.0 Fast (CA only), HappyHorse 1.1 by Alibaba (CA only) and Wan 3.0 by Tongyi Lab (CA only), and images with Seedream 5.5 (CA only), 5.0 Pro, 5.0 Flash (US only), 5.0 Lite (CA only), 4.7 (CA only), 4.6, 4.5, 4.1, 4.0, 3.1 (CA only) and 3.0, Nano Banana Pro and Nano Banana 2.1 (CA only), GPT Image 2.5 Flare and Sunburst, and GPT Image 2. CA only means a Canada-region Dreamina account, and US only a US one. Seedance 2.5 goes up to 1080p on US accounts and 4K on CA, the Seedance 2.0 models up to 4K on both, and a Seedance 2.5 Draft becomes a 1080p video, or 4K on CA.

The video and image examples read a list of prompts from prompts.json, submit them through the useapi.net Dreamina API, and download every result, so you can queue a batch and come back to the winners. seedance-draft/ makes one draft and its full-quality video. images/ and seedance-draft/ ship both a Node.js (.mjs) and a Python (.py) script, with no dependencies to install.

Example What it does Tutorial
seedance-video/ Batch-generate Seedance 2.5 and 2.0 video: text-to-video and first/last-frame image-to-video How to Generate AI Video with Seedance 2.5 and 2.0 via the Dreamina API
seedance-draft/ Make a 480p Seedance 2.5 draft, watch it, then turn the same video into 1080p or 4K (Node.js and Python) How to Draft Seedance 2.5 Videos at 480p and Finish Them in 1080p or 4K
images/ Batch-generate Seedream, Nano Banana and GPT Image pictures, with optional reference images (Node.js and Python) POST /images

The same Seedance 2.0 job on Dreamina, PixVerse, Runway and MiniMax, with a sourced price dataset, is in useapi/seedance-2-api.

Quick start

You need Node.js v21 or newer (no dependencies to install), a useapi.net API token, and a connected Dreamina account (one $15/month subscription covers every useapi.net API and 3 Dreamina accounts):

git clone https://github.com/useapi/dreamina-api.git
cd dreamina-api/seedance-video
node ./dreamina.mjs <API_TOKEN> <EMAIL>

Edit prompts.json in each folder to queue your own prompts. Every supported parameter is documented on the POST /videos and POST /images endpoint pages.

MCP server

useapi.net also runs a hosted Model Context Protocol server for Dreamina, so an AI assistant such as the Claude app, ChatGPT, Claude Code, Cursor or VS Code Copilot can use it on your Dreamina accounts. It has 15 tools: Seedance videos from text, first and last frames, keyframes or omni references (images, videos and audio cited in the prompt as @image1, @video1, @audio1), video upscale, a smoother frame rate, a Seedance 2.5 draft rendered in full quality, Seedream, GPT Image and Nano Banana images, uploads, your generation history and running jobs. unlimited: true uses Dreamina's Unlimited mode where your plan has it. Nothing to install or run locally.

  • Endpoint: https://api.useapi.net/v1/dreamina/mcp
  • Transport: Streamable HTTP
  • Authorization: your useapi.net API token in the Authorization: Bearer … header, and an account connected with the Dreamina setup. The Claude app and ChatGPT sign in with OAuth instead.
  • Listed in the official MCP Registry as net.useapi/dreamina

Claude Code:

claude mcp add --transport http useapi-dreamina https://api.useapi.net/v1/dreamina/mcp --header "Authorization: Bearer YOUR_API_TOKEN"

Cursor, VS Code, Windsurf, the Claude app, ChatGPT and the full tool list: Dreamina MCP server docs. useapi.net is a third-party API, not affiliated with Dreamina or ByteDance.

Use with Claude Code

This repo is also a Claude Code plugin marketplace. The plugin adds the hosted Dreamina MCP server, and reads your token from the USEAPI_TOKEN environment variable, so set it before you start Claude Code:

export USEAPI_TOKEN=user:12345-...      # your useapi.net API token

Then, inside Claude Code:

/plugin marketplace add useapi/dreamina-api
/plugin install dreamina@useapi-dreamina

On Claude Code 2.1.275 or later, /plugin install dreamina --marketplace useapi/dreamina-api does both in one step. Run /mcp to check that useapi-dreamina is connected.

Use with Gemini CLI

This repo is also a Gemini CLI extension with the same MCP server:

gemini extensions install https://github.com/useapi/dreamina-api

The install asks for your useapi.net API token and keeps it in the system keychain. Change it later with gemini extensions config useapi-dreamina, and check the connection with gemini mcp list.

Common questions

Does Dreamina have an API?

Yes, through useapi.net. The useapi.net Dreamina API runs Seedance 2.5, 2.0, 2.0 Fast and 2.0 Mini, HappyHorse 1.1 and Wan 3.0 on Canada accounts, and Seedream, GPT Image 2.5 and Nano Banana Pro images over REST on your Dreamina subscription, with no enterprise onboarding or approval. Dreamina itself is a website with no developer API (as of October 2026), and ByteDance's BytePlus ModelArk runs Seedance only after you buy a prepaid resource pack.

How much does the Dreamina API cost?

Through useapi.net, a 5-second Seedance 2.0 Fast video at 720p costs $0.37 on Dreamina Advanced, against $0.60 on ByteDance's BytePlus ModelArk, and Seedance 2.0 Mini costs $0.23 against $0.38 (as of October 2026). BytePlus also needs a prepaid resource pack before Seedance runs. The price table prices every model.

Is there a Dreamina API key?

Through useapi.net, you use our API token, since Dreamina issues no API key, and connect your Dreamina account once with its email and password through Setup Dreamina, with no BytePlus account and no prepaid token pack. Both regions run Seedance 2.5 and the Seedance 2.0 models, the 2.0 models at the same resolutions, up to 4K. Pick a Canada-region account for Seedance 2.5 Flash, Seedance 2.5 at 4K, Seedance 1.0 Pro and 1.0 Fast, HappyHorse 1.1 and Wan 3.0, and a US one for Seedance 1.5 Pro. A US or Canadian VPN is needed only to create the account in the browser.

Is there a Seedance 2.5 API that accepts real faces?

Yes, through useapi.net's Dreamina route, which accepts photographic portraits on Seedance 2.5 and runs long videos of 31 to 180 seconds in one job. ByteDance's own Seedance 2.5 guide says it "does not support directly uploading reference images or videos containing real human faces" and caps clips at 30 seconds (as of October 2026). Send seedance-2.5 to POST /videos.

How many Dreamina accounts can I connect?

Through useapi.net, each $15/month subscription covers 3 Dreamina accounts, and each extra $10/month subscription adds 3 more (as of October 2026). Each account runs up to 10 jobs at the same time by default (1 to 50 with maxJobs), and a request without an account goes to an account with free capacity.

More answers: Dreamina API questions and the Dreamina tutorial FAQ.

Tutorials

About useapi.net

useapi.net is a third-party REST API for AI services. The Dreamina API runs on your Dreamina subscription, so each video costs its share of the subscription's credits instead of metered developer-API pricing. See the models and prices on the Dreamina API overview and every service in the model matrix.

Visit our Discord Server or Telegram Channel for any support questions and concerns.

We regularly post guides and tutorials on the YouTube Channel.

License

The example code in this repository is released under the MIT License. It covers the example scripts only, not the useapi.net service or API.

Reviews (0)

No results found