本文へスキップ
Tecrübetecrube.com
First steps

Production guide: dashboard, MCP and API

How every job of the Production screen is done in the dashboard, in MCP clients such as Claude or ChatGPT and through the REST API: quote → confirm → produce → status → download, recipes, pricing and credits, limits, error codes, consent for a real person's avatar.

Three ways, one set of rules

  • Dashboard: the Production screen (/uretim). Pick a card, fill in the form, then use "See the price" and "Confirm and produce".
  • MCP: in Claude, ChatGPT and other assistants the connector address is https://tecrube.com/mcp. You describe what you want; the assistant calls the tools below.
  • REST API: the https://tecrube.com/api/v1/production/... endpoints with the Authorization: Bearer tk_... header. The dashboard uses the same endpoints.
  • All three call the same core functions: price, credit check, balance reservation, monthly limit, rate limits and validation are identical. There is no cheaper or rule-free way to produce through MCP or the API.

Capability inventory

Every capability of the Production screen and its counterparts. Tool parameters and credits are generated from code on the Production tools page; the endpoint schemas are in the OpenAPI reference.

CapabilityIn the dashboardMCP toolREST endpoint
Kinds, recipes, quality tiers and pricesNew production formget_production_optionsGET /production/overview · GET /production/formats
Opening line (hook) suggestionsForm › Opening suggestionssuggest_production_hooksPOST /production/hooks
Quote: what, for how much, until whenSee the pricequote_productionPOST /production/quotes
Variations (2–4)Form › Number of variationsquote_production variationsPOST /production/quotes/batch
Read a quoteQuote cardget_production_quoteGET /production/quotes/{id}
Start a confirmed quoteConfirm and producestart_productionPOST /production/jobs · POST /production/jobs/batch
One-step plain generation (no confirmation)—generate_content—
Library: search, filters, paginationProductions tablist_productionsGET /production/jobs
Everything about one productionProduction cardlist_productions production_idGET /production/jobs/{id}
Cancel a queued jobCard › Cancelcancel_productionPOST /production/jobs/{id}/cancel
Retry a failed job with the same settingsCard › Retryretry_productionPOST /production/jobs/{id}/retry
FavoriteCard › Starset_production_favoritePUT /production/jobs/{id}/favorite
Delete (also in bulk)Card › Delete · Select › Delete selecteddelete_productionDELETE /production/jobs/{id}
Download (PNG / JPG / WEBP)Card › Downloadget_production_downloadGET /production/jobs/{id}/download
Start from a product pageStart from a product pageimport_production_from_urlPOST /production/import-url
Upload your own imageUpload imageupload_production_imagePOST /production/assets
Adapt to ad formatsCard › Adapt to formatsadapt_production_formatsPOST /production/jobs/{id}/formats
Pre-flight checkCard › Pre-flight checkproduction_preflightGET /production/jobs/{id}/preflight
TV / connected TV master copyCard › Broadcast qualityget_production_masters · create_production_master · delete_production_masterGET / POST /production/jobs/{id}/masters · DELETE /production/masters/{id}
Brand film scenes and re-cutCard › Edit scenesget_production_film · edit_production_filmGET /production/jobs/{id}/film · POST /production/jobs/{id}/film/edit
Regenerate a single sceneScenes › Regenerate this scenequote_production recipe: scenePOST /production/quotes recipe: scene
More like thisAd result › Make more like thisquote_production like_production_idGET /production/jobs/{id} → POST /production/quotes (hook, angle)
Review link, decision and commentsCard › Sharecreate_production_share · get_production_share · revoke_production_sharePOST / GET / DELETE /production/jobs/{id}/share
Characters (AI influencer, AI avatar)Characters › New characterget_production_options topic: characters · create_production_character · delete_production_characterGET / POST /production/characters · DELETE /production/characters/{id}
Balance, credits and ledgerBalance tabget_production_walletGET /production/wallet · GET /production/wallet/ledger
Monthly spending limitBalance › Monthly spending limitset_production_monthly_limitPUT /production/wallet/limit
Add a production to a campaignChat · campaign creativesadd_production_to_campaignPOST /production/jobs/{id}/campaign
Ad results and best variationCard › Ad results · Variationslist_productions (performance, batch_result, review)GET /production/jobs (performance, batch_result, review)

Kinds and recipes

Five basic kinds and eight ready-made recipes; all are requested with quote_production (MCP) and POST /production/quotes (REST). The recipe is the recipe field.

RecipeWhat you getKind (`kind`)Needs
—Basic kinds: image, short video, UGC video, voice-over, script.image · short_video · ugc_video · voice · scriptbrief
productImage or video from a product photo; the product stays, the scene (style) changes.image · short_video · ugc_videoreference_id, style
editA new version of a ready file; brief is the change to make.image · short_video · ugc_videoreference_id, brief
personaAn AI portrait to save as a character.imagebrief
influencerConsistent content with a saved virtual character.image · short_video · ugc_videocharacter_id (virtual)
avatarContent with a consented real person's character.image · short_video · ugc_videocharacter_id (real)
filmMulti-scene brand film with on-screen captions and a closing card with your logo.short_videoscenes, captions, end_card
sceneOne scene of a ready film; only that scene is charged, scene: 1 + hook changes only the opening.short_videoreference_id, scene, hook
dubbingA ready video in another language.short_video · ugc_videoreference_id, language
packAd formats from one main image, plus an optional short video.imageformats, video

End to end with MCP

Plain language is enough; the assistant works in this order.

  1. Options: get_production_options reads kinds, tiers and prices (no invented numbers).
  2. Quote: quote_production returns what will be produced and the price. Nothing is produced, no credits are used.
  3. Confirmation: the assistant shows you the price and waits for your approval.
  4. Start: after you confirm, start_production starts the quote; the price is reserved at this step.
  5. Status and file: list_productions gives the status and the address of the ready file; get_production_download makes a download address in the type you want.

Example prompt: "Make a warm-toned 4:5 autumn poster for my coffee shop. Tell me the price first and produce it if I approve."

quote_production
// quote_production
{ "kind": "image", "brief": "Autumn coffee campaign poster, warm tones", "aspect": "4:5", "tier": "balanced" }

// result (nothing produced or charged yet)
{ "ok": true, "status": "awaiting_confirmation", "started": false,
  "quote": { "quote_id": "6f0c…", "kind": "image", "pricing": "credits", "price": { "credits": 24 },
             "credits_remaining": 5810, "enough_credits": true, "expires_at": "2026-11-18T10:30:00+00:00" },
  "confirm_with": { "tool": "start_production", "arguments": { "quote_id": "6f0c…" } } }
start_production · list_productions · get_production_download
// start_production — only after the user confirmed the price
{ "quote_id": "6f0c…" }
// → { "ok": true, "production_id": "a1b2…", "status": "queued", … }

// list_productions — repeat until status is "ready"
{ "production_id": "a1b2…" }
// → { "items": [ { "id": "a1b2…", "status": "ready", "url": "https://tecrube.com/medya/…", "file": { "width": 1080, "height": 1350 } } ] }

// get_production_download — a JPG copy at a signed address that expires
{ "production_id": "a1b2…", "format": "jpg" }

Recipe examples (MCP arguments)

json
// From a product page: page facts + the main image into the library
{ "url": "https://shop.example.com/product/123", "confirm_rights": true }            // import_production_from_url

// Product video from that photo, three variations (the total price comes back)
{ "kind": "short_video", "recipe": "product", "reference_id": "<image id>", "brief": "…", "variations": 3 }   // quote_production

// Dub a ready video into German
{ "kind": "short_video", "recipe": "dubbing", "reference_id": "<video id>", "language": "de" }               // quote_production

// "More like this": the winner's settings, a new aspect
{ "like_production_id": "<winner id>", "aspect": "9:16" }                                                       // quote_production

End to end with the REST API

The same flow with curl. The id in the quote response is the quote id; the id in the POST /production/jobs response is the production id.

bash
API=https://tecrube.com/api/v1
KEY=tk_your_key

# 1) Quote — nothing is produced or charged (Idempotency-Key returns the same quote on retry)
curl -X POST $API/production/quotes \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -H "Idempotency-Key: autumn-poster-1" \
  -d '{"kind":"image","brief":"Autumn coffee campaign poster, warm tones","aspect":"4:5","tier":"balanced"}'
# → {"id":"<quote_id>","mode":"credits","credits":24,"price_usd":0,"expires_at":"…",…}

# 2) Confirm and start (the same quote_id never starts a second production)
curl -X POST $API/production/jobs \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -d '{"quote_id":"<quote_id>"}'

# 3) Status — repeat until "status":"ready" (running jobs carry "eta")
curl $API/production/jobs/<job_id> -H "Authorization: Bearer $KEY"

# 4) Download as JPG (png | jpg | webp; images only)
curl -o poster.jpg "$API/production/jobs/<job_id>/download?format=jpg" -H "Authorization: Bearer $KEY"

Examples from other endpoints

bash
# Library: search, filter, paginate
curl "$API/production/jobs?q=autumn&kind=image&status=ready&favorite=true&limit=20&offset=0" -H "Authorization: Bearer $KEY"

# Variations: 2–4 quotes in one request, then one confirmation
curl -X POST $API/production/quotes/batch -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"kind":"image","brief":"New collection","variations":3,"hooks":["Autumn is here","New season"]}'
curl -X POST $API/production/jobs/batch -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"quote_ids":["<q1>","<q2>","<q3>"]}'

# Adapt a ready image to ad formats (format ids: GET /production/formats?platform=meta&type=image)
curl -X POST $API/production/jobs/<job_id>/formats -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"formats":[12,14],"headline":"New season","cta":"Shop now","logo":true}'

# Review link for 14 days, then read the decision and comments
curl -X POST $API/production/jobs/<job_id>/share -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -d '{"days":14}'
curl $API/production/jobs/<job_id>/share -H "Authorization: Bearer $KEY"

# TV master copy (ProRes 422 HQ, 30 s, PAL)
curl -X POST $API/production/jobs/<job_id>/masters -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"profile":"tv_pal","codec":"prores","seconds":30}'

# Use it in a campaign
curl -X POST $API/production/jobs/<job_id>/campaign -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"campaign_id":"<campaign_id>"}'

Pricing and credits

  • Pricing mode: productions are paid either with plan credits (pricing: credits) or with the production balance (pricing: balance, USD); the active mode is in get_production_options and GET /production/overview.
  • The price comes first: every quote states what will be produced, the amount and its validity (expires_at). An expired quote cannot be started; a new one is priced at today's rate.
  • When it is charged: in balance mode the amount is reserved at start and charged when the file is ready; if the job fails or is cancelled the reservation is returned. In credit mode the start checks that the remaining credits cover the job, and the credits are used when the file is produced.
  • Not enough, no start: if credits or balance do not cover it, or the monthly limit would be passed, the job does not start; the response states the needed and remaining amounts.
  • Same price everywhere: prices are set so that every job covers its cost, and the dashboard, MCP and the API apply the same price.
  • MCP tool fee: calling the production tools costs nothing extra (0 credits); only reading a product page, uploading an image from an address and opening line suggestions cost 1 credit. The production's price is the amount in its quote.

Confirmation: when are you charged?

  • quote_production and retry_production only create a quote; they produce and charge nothing.
  • start_production reserves the price or uses credits; the assistant should call it only after you have seen the price and explicitly approved. The tool is marked as one that asks for confirmation (destructive) in clients.
  • The dashboard chat does not start a quote taken in the same turn (confirmation_required): approval must come after the message where you saw the price.
  • Starting the same quote twice does not open a second production; the first one is returned. In REST, Idempotency-Key returns the same quote.

After production

  • Adapt to formats: a ready image is converted to the aspect ratios of up to 12 placements; headline, call to action and logo stay in the safe area. Free.
  • Pre-flight check: without a target it lists the placements and broadcast profiles; with format_id or profile the file itself is measured and a pass / warn / fail list comes back.
  • Broadcast quality: from a ready video, a ProRes 422 HQ or H.264 master copy for TV PAL (1080p25, −23 LUFS), TV NTSC (1080p29.97, −24 LKFS) or connected TV, with a technical report. Free; it does not guarantee a broadcaster's acceptance.
  • Video engine: for videos you can pick the model by name instead of a quality tier (Seedance 2.0 and 2.5 at 1080p; 2.5 Flash, 2.0 Fast and 2.0 Mini at 720p, all with audio). Put the model id in tier, e.g. bytedance/seedance-2.0; the list and prices come from get_production_options or GET /production/overview › tiers with engine_name. A disabled engine is refused with engine_unavailable instead of being priced with another model.
  • Brand film: scene order, captions and closing card are re-cut for free as a new version; the old one stays. Regenerating a single scene is charged and goes through a quote.
  • Sharing: a review link without login, valid 1–90 days; the address is shown only once at creation and earlier links of the production are closed. Read the reviewer's decision and comments with get_production_share; close the link whenever you want.
  • Add to a campaign: the production becomes a draft creative card of the campaign. On Meta and Google the file is used when the campaign is published; a live ad does not change by itself.
  • Ad results: a production used in ads shows campaign-level numbers (performance) and, for variations, the comparison (batch_result). "Best result" is marked only in a fair comparison.
  • Delete: permanent and cannot be undone. Content used in a campaign (in_use) or still rendering (active) is not deleted. The assistant should call delete tools only when you explicitly ask.

A real person's avatar and consent

  • A virtual character (AI influencer) needs only a ready face image.
  • A real person's avatar is saved only with a consent statement: the person's name, the basis (self: you are the person in the photo · written: the person gave written permission) and explicit confirmation (confirmed: true). The statement is recorded with your account and the time.
  • Only you give the statement. The assistant cannot fill these fields in on your behalf; the dashboard chat never creates a real person's character and sends you to the form.
  • Deleting the character withdraws the consent; files produced earlier stay in the library.
json
// create_production_character (MCP) · POST /production/characters (REST)
{ "name": "Ayşe", "type": "real", "image_id": "<photo id>",
  "consent": { "person_name": "Ayşe Yılmaz", "basis": "self", "confirmed": true } }

Limits

TopicLimit
Image uploadPNG, JPEG or WEBP; up to 12 MB; sides 200–4,096 px; up to 500 uploads in the library
Request text (brief)Up to 2,000 characters; opening line up to 160 characters
Variations2–4 (the platform admin may lower the maximum)
Opening line suggestions5–8 per call
Format adaptationUp to 12 formats per request
Bulk delete (MCP)Up to 24 productions per call
Review link1–90 days (default 14)
Brand filmUp to 12 scenes; up to 12 versions per production
Broadcast masterSpot length 10, 15, 20, 30, 45 or 60 s; the source is extended by at most 3 s; source video up to 185 s; up to 8 copies per production
CharactersUp to 50 per account
Rate limits (per hour, per account)Quotes 120 · uploads 60 · adaptation 120 · characters 40 · masters 20 · pre-flight 180 · re-cut 30 · opening suggestions 40 · product page 20 · sharing 60 · download 240

Error codes

CodeRESTMeaning and what to do
credits_exhausted402Plan credits do not cover this job; the response states needed and remaining. Upgrade or buy extra credits on the Plan screen.
insufficient_balance402The production balance is not enough; top it up on the Production screen.
monthly_limit402Your monthly limit would be passed; change it or wait for next month.
quote_expired · quote_cancelled410 · 409The quote expired or was cancelled; get a new one (the price may have changed).
not_found404The id does not exist in this account (another account's record looks the same). Take the id from the list tool or endpoint.
read-only · read_only403A read-scoped key or the viewer role cannot do write jobs.
needs_provider—A production status: no AI provider is connected and only the script was written; it can be retried once a provider is connected.
rate_limited429The hourly limit is reached; retry after retry_after seconds.
reference_required · reference · character_required · language · formats422The source, character, language or format the recipe needs is missing or invalid; hint in the response says what to do.
rendering · in_use · active · not_ready409A job already at the provider cannot be stopped; content in a campaign or still rendering is not deleted; a file that is not ready is not added to a campaign.
consent422The rights confirmation (product page) or the consent statement (real person) is missing.
unsafe · unsafe_url422Internal or local addresses are not read; give a public http(s) address.

Next steps