Build on NoodleTomato.

Bring your own agent (MCP)

• Your agent, your client. Connect a compatible MCP client using token-authenticated Streamable HTTP. Create a scoped, revocable connection in your developer settings and follow the setup instructions for your client.
• Reasoning is paid where it runs. Your client does the thinking on the plan you already have; NoodleTomato never receives your client's credentials and never charges you for that reasoning.
• Media comes out of your credits. Images, video, voice and music that NoodleTomato makes are quoted and charged in credits, on the same ledger the studio uses.
• An active NoodleTomato plan is required. Any plan qualifies. A connection cannot be used while the plan is inactive, even with credits left.
• The tools cover projects and media: brief a video, create or reuse reference images, generate clips, pick voices, check quotes and balance, and collect the finished assets.

The API

• Keys are created, scoped and revoked in your developer settings, and only work while your plan is active.
• Every generation is a job: submit it, poll its status, cancel it while queued, and fetch its assets when done.
• Ask for a quote before you submit. Credits are reserved on submission. Final charges stay within the quote, and unused reserved credits are released.
• Text to video returns a finished clip. Its quote covers the whole job, reference frame included.
• Image to video animates a frame you upload or one you made here. Reference images have explicit quality levels, and higher quality costs more.

What it covers

CatalogOptions and capabilities

List the generation options, sizes, durations and image quality levels your key can use, then request a quote for your chosen settings.

Text to videoA prompt in, a clip out

Send a prompt and get a finished clip. One quote covers the whole job, reference frame included.

Image to videoAnimate your own frame

Start from an image you upload or one you made here, pick length and size, and get the clip back.

Reference imagesFrames for your shots

Make reference images at an explicit quality level, and reuse them across clips for a consistent look.

Async jobsSubmit, poll, cancel, fetch

Every generation is a job: submit it, check its status, cancel it while it is queued, and download the assets when it is done.

Quotes and usageKnow the price first

Ask for a quote before you submit, see your balance and usage, and reserve credits when you submit a job.

AuthScoped, revocable keys

Create keys in your developer settings, scope them to what they may do, and revoke them any time. Keys need an active plan.

Quick start

Quote a six-second clip on NoodleTomato Motion, start it, then poll until it is done. Base URL https://app.noodletomato.com/api/backend, bearer keys from your developer settings.

1. 01Quote it

   curl -X POST https://app.noodletomato.com/api/backend/v1/media/estimate \
     -H "Authorization: Bearer $NOODLETOMATO_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "modelId": "video.motion", "modelVersion": 1,
       "modeId": "text-to-video", "modeVersion": 1,
       "prompt": "A red desert canyon river at sunrise from a drone, slow forward flight, wind",
       "settings": {
         "aspect": "16:9", "durationSec": 6,
         "referenceImage": "image.detail", "referenceQuality": "medium"
       }
     }'

   Returns estimatedCredits and its components: the reference frame and the clip. You choose the frame's engine and quality, and the quote covers both.

2. 02Start it

   curl -X POST https://app.noodletomato.com/api/backend/v1/media/generations \
     -H "Authorization: Bearer $NOODLETOMATO_API_KEY" \
     -H "Idempotency-Key: $(uuidgen)" \
     -H "Content-Type: application/json" \
     -d '{
       "modelId": "video.motion", "modelVersion": 1,
       "modeId": "text-to-video", "modeVersion": 1,
       "prompt": "A red desert canyon river at sunrise from a drone, slow forward flight, wind",
       "settings": {
         "aspect": "16:9", "durationSec": 6,
         "referenceImage": "image.detail", "referenceQuality": "medium"
       }
     }'

   Responds 202 with the generation id and reserves the quoted credits. Replaying the same Idempotency-Key returns the same generation instead of charging twice.

3. 03Poll it

   curl https://app.noodletomato.com/api/backend/v1/media/generations/$GENERATION_ID \
     -H "Authorization: Bearer $NOODLETOMATO_API_KEY"

   status moves from queued to running to succeeded, failed or cancelled. On success, result.url is a short-lived download link and chargedTokens is what it cost; anything reserved beyond that is released.

Endpoints

Completion is read by polling; there are no callbacks yet. The same operations are available as MCP tools with the same key.