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 theAuthorization: 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.
| Capability | In the dashboard | MCP tool | REST endpoint |
|---|---|---|---|
| Kinds, recipes, quality tiers and prices | New production form | get_production_options | GET /production/overview · GET /production/formats |
| Opening line (hook) suggestions | Form › Opening suggestions | suggest_production_hooks | POST /production/hooks |
| Quote: what, for how much, until when | See the price | quote_production | POST /production/quotes |
| Variations (2–4) | Form › Number of variations | quote_production variations | POST /production/quotes/batch |
| Read a quote | Quote card | get_production_quote | GET /production/quotes/{id} |
| Start a confirmed quote | Confirm and produce | start_production | POST /production/jobs · POST /production/jobs/batch |
| One-step plain generation (no confirmation) | — | generate_content | — |
| Library: search, filters, pagination | Productions tab | list_productions | GET /production/jobs |
| Everything about one production | Production card | list_productions production_id | GET /production/jobs/{id} |
| Cancel a queued job | Card › Cancel | cancel_production | POST /production/jobs/{id}/cancel |
| Retry a failed job with the same settings | Card › Retry | retry_production | POST /production/jobs/{id}/retry |
| Favorite | Card › Star | set_production_favorite | PUT /production/jobs/{id}/favorite |
| Delete (also in bulk) | Card › Delete · Select › Delete selected | delete_production | DELETE /production/jobs/{id} |
| Download (PNG / JPG / WEBP) | Card › Download | get_production_download | GET /production/jobs/{id}/download |
| Start from a product page | Start from a product page | import_production_from_url | POST /production/import-url |
| Upload your own image | Upload image | upload_production_image | POST /production/assets |
| Adapt to ad formats | Card › Adapt to formats | adapt_production_formats | POST /production/jobs/{id}/formats |
| Pre-flight check | Card › Pre-flight check | production_preflight | GET /production/jobs/{id}/preflight |
| TV / connected TV master copy | Card › Broadcast quality | get_production_masters · create_production_master · delete_production_master | GET / POST /production/jobs/{id}/masters · DELETE /production/masters/{id} |
| Brand film scenes and re-cut | Card › Edit scenes | get_production_film · edit_production_film | GET /production/jobs/{id}/film · POST /production/jobs/{id}/film/edit |
| Regenerate a single scene | Scenes › Regenerate this scene | quote_production recipe: scene | POST /production/quotes recipe: scene |
| More like this | Ad result › Make more like this | quote_production like_production_id | GET /production/jobs/{id} → POST /production/quotes (hook, angle) |
| Review link, decision and comments | Card › Share | create_production_share · get_production_share · revoke_production_share | POST / GET / DELETE /production/jobs/{id}/share |
| Characters (AI influencer, AI avatar) | Characters › New character | get_production_options topic: characters · create_production_character · delete_production_character | GET / POST /production/characters · DELETE /production/characters/{id} |
| Balance, credits and ledger | Balance tab | get_production_wallet | GET /production/wallet · GET /production/wallet/ledger |
| Monthly spending limit | Balance › Monthly spending limit | set_production_monthly_limit | PUT /production/wallet/limit |
| Add a production to a campaign | Chat · campaign creatives | add_production_to_campaign | POST /production/jobs/{id}/campaign |
| Ad results and best variation | Card › Ad results · Variations | list_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.
| Recipe | What you get | Kind (`kind`) | Needs |
|---|---|---|---|
| — | Basic kinds: image, short video, UGC video, voice-over, script. | image · short_video · ugc_video · voice · script | brief |
product | Image or video from a product photo; the product stays, the scene (style) changes. | image · short_video · ugc_video | reference_id, style |
edit | A new version of a ready file; brief is the change to make. | image · short_video · ugc_video | reference_id, brief |
persona | An AI portrait to save as a character. | image | brief |
influencer | Consistent content with a saved virtual character. | image · short_video · ugc_video | character_id (virtual) |
avatar | Content with a consented real person's character. | image · short_video · ugc_video | character_id (real) |
film | Multi-scene brand film with on-screen captions and a closing card with your logo. | short_video | scenes, captions, end_card |
scene | One scene of a ready film; only that scene is charged, scene: 1 + hook changes only the opening. | short_video | reference_id, scene, hook |
dubbing | A ready video in another language. | short_video · ugc_video | reference_id, language |
pack | Ad formats from one main image, plus an optional short video. | image | formats, video |
End to end with MCP
Plain language is enough; the assistant works in this order.
- Options:
get_production_optionsreads kinds, tiers and prices (no invented numbers). - Quote:
quote_productionreturns what will be produced and the price. Nothing is produced, no credits are used. - Confirmation: the assistant shows you the price and waits for your approval.
- Start: after you confirm,
start_productionstarts the quote; the price is reserved at this step. - Status and file:
list_productionsgives the status and the address of the ready file;get_production_downloadmakes 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
{ "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 — 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)
// 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_productionEnd 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.
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
# 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 inget_production_optionsandGET /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_productionandretry_productiononly create a quote; they produce and charge nothing.start_productionreserves 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-Keyreturns 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_idorprofilethe 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 fromget_production_optionsorGET /production/overview›tierswithengine_name. A disabled engine is refused withengine_unavailableinstead 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.
// 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
| Topic | Limit |
|---|---|
| Image upload | PNG, 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 |
| Variations | 2–4 (the platform admin may lower the maximum) |
| Opening line suggestions | 5–8 per call |
| Format adaptation | Up to 12 formats per request |
| Bulk delete (MCP) | Up to 24 productions per call |
| Review link | 1–90 days (default 14) |
| Brand film | Up to 12 scenes; up to 12 versions per production |
| Broadcast master | Spot 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 |
| Characters | Up 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
| Code | REST | Meaning and what to do |
|---|---|---|
credits_exhausted | 402 | Plan credits do not cover this job; the response states needed and remaining. Upgrade or buy extra credits on the Plan screen. |
insufficient_balance | 402 | The production balance is not enough; top it up on the Production screen. |
monthly_limit | 402 | Your monthly limit would be passed; change it or wait for next month. |
quote_expired · quote_cancelled | 410 · 409 | The quote expired or was cancelled; get a new one (the price may have changed). |
not_found | 404 | The 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_only | 403 | A 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_limited | 429 | The hourly limit is reached; retry after retry_after seconds. |
reference_required · reference · character_required · language · formats | 422 | The 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_ready | 409 | A 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. |
consent | 422 | The rights confirmation (product page) or the consent statement (real person) is missing. |
unsafe · unsafe_url | 422 | Internal or local addresses are not read; give a public http(s) address. |
Next steps
- Production toolsImages, videos, voice-overs and scripts: quote and confirmation, every recipe, the library, format adaptation, broadcast quality, sharing and characters.
- API and clientsAPI key authentication on the Enterprise plan: scopes, rate limits, the OpenAPI reference, Python and JavaScript clients, and connecting with the MCP SDKs.
- Credits & UsageEvery tool call spends a few credits: reads are cheap, live changes cost more. 100 lifetime credits on the Starter plan, monthly renewing credits on paid plans; failed calls are refunded.