MCP 서버

Dreambooth Studio

com.dreamboothstudio/dreambooth
비즈니스 및 운영 IoT 및 하드웨어 공개 · 연결 가능 MCP 2025-11-25

이 MCP로 할 수 있는 일

Provides photobooth operators with session, revenue, wallet, credit, gallery, project, device-status, and product-documentation information.

check_generation
Check background work
Report on background work started by start_frame, refine_frame, start_booth, refine_booth or create_booth. Always pass the jobId that the start/refine/create call returned — keep it for the rest of the conversation, because an id keeps working for the full 15 minutes even if the connection re-authenticates partway through, and calling with no arguments does not. With no arguments it reports the most recent job of any kind, which is a convenience for when the id was lost, not the normal way to call it. Designing a booth takes 1-3 minutes, a redraw about a minute, creating a booth 2-6 minutes: tell the operator that, then poll about every 15 seconds. While it says 'running', nothing exists yet — relay the progress line if there is one, tell the operator it is still going, and wait 10-15 seconds before calling again rather than polling tightly. When it says 'done': a frame job carries imageUrl, threadId and generationId (a preview — nothing saved until save_frame); a booth design carries draft{…} (a draft — nothing created until create_booth); a booth creation carries booth{slug, boothUrl, projectId} — the one case where something now exists. This reads a status and creates nothing, so it is always safe to call.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'jobId': {'type': 'string', 'description': 'The id a start/refine/create tool returned. Pass it whenever you have it. Omit only if it was lost, which falls back to the most recent job listed for this connection.'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['kind', 'state', 'what'], 'properties': {'kind': {'enum': ['generation', 'booth-draft', 'booth', 'job'], 'type': 'string'}, 'note': {'type': 'string'}, 'what': {'type': 'string'}, 'booth': {'type': 'object', 'required': ['slug', 'title', 'boothUrl', 'dashboardUrl', 'ownFrameCount', 'catalogFrameCount', 'filterCount'], 'properties': {'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'aiEffect': {'type': 'string'}, 'boothUrl': {'type': 'string'}, 'imageUrl': {'type': 'string'}, 'projectId': {'type': 'string'}, 'filterCount': {'type': 'number'}, 'dashboardUrl': {'type': 'string'}, 'ownFrameCount': {'type': 'number'}, 'catalogFrameCount': {'type': 'number'}}, 'additionalProperties': False}, 'draft': {'type': 'object', 'required': ['draftId', 'slug', 'title', 'headline', 'subtext', 'cta', 'captureMode', 'language', 'palette', 'welcomePortraitUrl', 'welcomeLandscapeUrl', 'appBackgroundUrl', 'frameTags', 'filterMood', 'remainingFullGenerations', 'remainingRegens'], 'properties': {'cta': {'type': 'string'}, 'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'edited': {'type': 'array', 'items': {'type': 'string'}}, 'draftId': {'type': 'string'}, 'logoUrl': {'type': 'string'}, 'palette': {'type': 'object', 'required': ['backgroundColor', 'primaryColor', 'secondaryColor', 'dark'], 'properties': {'dark': {'type': 'boolean'}, 'primaryColor': {'type': 'string'}, 'secondaryColor': {'type': 'string'}, 'backgroundColor': {'type': 'string'}}, 'additionalProperties': False}, 'subtext': {'type': 'string'}, 'frameIds': {'type': 'array', 'items': {'type': 'string'}}, 'headline': {'type': 'string'}, 'language': {'type': 'string'}, 'settings': {'type': 'object', 'additionalProperties': {'type': 'object', 'additionalProperties': {'type': ['boolean', 'number', 'null']}}}, 'filterIds': {'type': 'array', 'items': {'type': 'string'}}, 'frameTags': {'type': 'array', 'items': {'type': 'string'}}, 'aiEffectId': {'type': 'string'}, 'filterMood': {'type': 'string'}, 'captureMode': {'type': 'string'}, 'regenerated': {'type': 'array', 'items': {'type': 'string'}}, 'remainingRegens': {'type': 'number'}, 'appBackgroundUrl': {'type': 'string'}, 'welcomePortraitUrl': {'type': 'string'}, 'welcomeLandscapeUrl': {'type': 'string'}, 'remainingFullGenerations': {'type': 'number'}}, 'additionalProperties': False}, 'error': {'type': 'string'}, 'jobId': {'type': 'string'}, 'state': {'type': 'string'}, 'layout': {'type': 'string'}, 'imageUrl': {'type': 'string'}, 'progress': {'type': 'string'}, 'threadId': {'type': 'string'}, 'canvasWidth': {'type': 'number'}, 'canvasHeight': {'type': 'number'}, 'dashboardUrl': {'type': 'string'}, 'generationId': {'type': 'string'}, 'placeholderCount': {'type': 'number'}}, 'additionalProperties': False}
connect_account
Connect or create a Dreambooth account
Connect this conversation to a Dreambooth Studio account. Returns a link the person opens in their own browser, where they sign in to Dreambooth with an email and password or with Google, and approve. Works for people who do NOT have a Dreambooth account yet — approving creates one, with a 14-day Pro trial — as well as for existing operators. Call this when another tool reports that no account is connected, or when someone asks to connect, sign up, or switch accounts. After returning the link, ask them to open it and say when they are done; do not call this tool again while waiting.
외부 접근 가능
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'message'], 'properties': {'email': {'type': ['string', 'null']}, 'status': {'type': 'string', 'description': 'already_connected | awaiting_approval'}, 'authUrl': {'type': 'string', 'description': 'Open in a browser to approve. Absent when already connected.'}, 'message': {'type': 'string'}, 'expiresInMinutes': {'type': 'number'}, 'createsAccountIfNeeded': {'type': 'boolean'}}, 'additionalProperties': False}
connection_status
Check Dreambooth connection
Whether this conversation currently has a Dreambooth account connected, and which one. Call this if you are unsure whether to run connect_account first. Cheap and read-only — it does not contact Dreambooth.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['connected', 'phase', 'email', 'waitingSeconds', 'message'], 'properties': {'email': {'type': ['string', 'null']}, 'phase': {'enum': ['connected', 'waiting', 'expired', 'idle'], 'type': 'string'}, 'message': {'type': 'string'}, 'connected': {'type': 'boolean'}, 'waitingSeconds': {'type': ['number', 'null'], 'description': 'How long the current device flow has been pending'}}, 'additionalProperties': False}
create_booth
Create the booth
Create the booth from a finished draft — the step that makes something real, live at its public link. Call it only after the operator has seen the draft via check_generation and agreed to create it; the title and link name (slug) default to the draft's unless the operator chose others. It reads the draft first (so everything set with update_booth_draft — settings, frames, filters, AI effect — is carried), checks the link name, draws the booth's own three photo-strip frames (3 images, up to five minutes), adds three starter frames from the catalogue and the Studio's default 'Normal' filter the way dreambooth.app/new does, then creates the booth with the draft's welcome design, background, colour theme and capture mode. Frames saved with save_frame and filters made with create_filter on this connection are carried automatically; ids can also be passed. Tell the operator it takes 2-6 minutes. Returns a job id; check_generation reports progress and, when done, the booth's public link, id and a dashboard link. If the link name is taken it stops before drawing anything — ask for another and call again. Creating twice with different link names makes two booths. The booth is live (unlisted) at once; there is no tool that edits or deletes a booth — changes happen in the dashboard.
외부 접근 가능
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['draftId'], 'properties': {'slug': {'type': 'string', 'pattern': '^[a-z0-9]+(?:-[a-z0-9]+)*$', 'maxLength': 44, 'minLength': 3, 'description': "The link name: lowercase letters, digits and single hyphens (dreambooth.app/<slug>). Leave unset to use the draft's proposed slug."}, 'title': {'type': 'string', 'maxLength': 80, 'minLength': 2, 'description': "The booth's name. Leave unset to use the draft's title (as shown by check_generation / set with update_booth_draft)."}, 'draftId': {'type': 'string', 'pattern': '^dft_[a-f0-9]{24}$', 'description': 'The draft to create, from check_generation.'}, 'frameIds': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-f0-9]{24}$'}, 'maxItems': 20, 'description': 'Ids of frames to include â\x80\x94 e.g. a frame the operator just saved with save_frame. Starter frames are added anyway.'}, 'filterIds': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-f0-9]{24}$'}, 'maxItems': 20, 'description': "Ids of filters to include â\x80\x94 e.g. one the operator just made with create_filter. The default 'Normal' filter is added anyway."}, 'captureMode': {'enum': ['standard', 'frame-based'], 'type': 'string', 'description': "Leave unset to keep what the draft proposed ('standard' = classic strip, 'frame-based' = frame mode)."}, 'aiEffectTitle': {'type': 'string', 'maxLength': 80, 'description': 'The title of a public AI effect to add, exactly as the operator named it. Leave unset for none.'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['kind', 'jobId', 'state', 'what'], 'properties': {'kind': {'type': 'string', 'const': 'booth'}, 'note': {'type': 'string'}, 'slug': {'type': 'string'}, 'what': {'type': 'string'}, 'error': {'type': 'string'}, 'jobId': {'type': 'string'}, 'state': {'type': 'string'}, 'draftId': {'type': 'string'}}, 'additionalProperties': False}
create_filter
Create a photo filter
Create a new photo filter on this operator's account from a description of the look they want — 'warm and slightly faded', 'high contrast black and white'. Translate the description into the adjustment numbers yourself; the ranges are in the schema. Call this only when the operator asks for a filter to be CREATED. It does not change an existing filter, and there is no tool that does — to edit or delete one, send them to the dashboard. Creating the same filter twice makes two filters, so do not retry a call that may have gone through.
외부 접근 가능
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name', 'adjustments'], 'properties': {'name': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': "What the operator will see in their filter list. Use their words if they named it; otherwise a short descriptive name, not 'Untitled'."}, 'isPublic': {'type': 'boolean', 'description': 'Leave unset unless the operator explicitly asks for the filter to be shared. Default is private to their account.'}, 'adjustments': {'type': 'object', 'properties': {'blur': {'type': 'number', 'maximum': 10, 'minimum': 0, 'description': '0 = off, in pixels'}, 'tint': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged, positive = magenta'}, 'grain': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': '0 = off'}, 'sepia': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': '0 = off'}, 'blacks': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged'}, 'dehaze': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged'}, 'whites': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged'}, 'clarity': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged'}, 'shadows': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged, positive = lifted'}, 'contrast': {'type': 'number', 'maximum': 200, 'minimum': 0, 'description': '100 = unchanged'}, 'exposure': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged'}, 'vibrance': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged'}, 'vignette': {'type': 'number', 'maximum': 200, 'minimum': 0, 'description': '0 = off'}, 'grayscale': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': '0 = off, 100 = black and white'}, 'hueRotate': {'type': 'number', 'maximum': 360, 'minimum': 0, 'description': '0 = unchanged, in degrees'}, 'brightness': {'type': 'number', 'maximum': 200, 'minimum': 0, 'description': '100 = unchanged'}, 'highlights': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged'}, 'saturation': {'type': 'number', 'maximum': 200, 'minimum': 0, 'description': '100 = unchanged, 0 = grey'}, 'temperature': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged, positive = warmer'}}, 'description': 'Only include what the operator asked to change. An omitted adjustment keeps its neutral value; sending every field at its neutral value creates a filter that does nothing.', 'additionalProperties': False}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['kind'], 'properties': {'id': {'type': 'string'}, 'kind': {'type': 'string', 'const': 'filter'}, 'name': {'type': 'string'}, 'isPublic': {'type': 'boolean'}, 'previewUrl': {'type': 'string'}, 'adjustments': {'type': 'object', 'additionalProperties': {'type': 'number'}}, 'dashboardUrl': {'type': 'string'}}, 'additionalProperties': False}
duplicate_project
Duplicate a booth
Copy one of this operator's existing booths, with all of its settings, into a new one. Use it when they want another booth 'like' one they already run — a second location, a one-off event, a variant to experiment on. Call list_projects first to get the project id; the operator will name the booth, not its id. The copy is named after the original and is not published at the original's public address, so it is safe to make and they can rename it in the dashboard. To design a NEW booth from a description, use start_booth instead of this; there is no tool that edits or deletes a booth that already exists.
외부 접근 가능
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId'], 'properties': {'projectId': {'type': 'string', 'minLength': 1, 'description': 'The id of the booth to copy, from list_projects. Not its name or slug.'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['kind'], 'properties': {'id': {'type': 'string'}, 'kind': {'type': 'string', 'const': 'booth'}, 'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'isActive': {'type': 'boolean'}, 'copiedFrom': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': False}, 'dashboardUrl': {'type': 'string'}}, 'additionalProperties': False}
get_booth_draft
Read a booth draft
Read a booth draft by its draftId — the same summary check_generation gives for a finished design, plus everything the draft has been given since (settings, chosen frames, filters, AI effect). Use it when the job from start_booth is no longer tracked, to show the draft again before create_booth, or to confirm what update_booth_draft applied. Reads only; nothing is generated or created. A draft lives 7 days on the operator's account.
읽기 전용 외부 접근 가능 멱등성
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['draftId'], 'properties': {'draftId': {'type': 'string', 'pattern': '^dft_[a-f0-9]{24}$', 'description': 'The draft, from check_generation or a previous tool result.'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['kind', 'jobId', 'state', 'what', 'draftId'], 'properties': {'kind': {'type': 'string', 'const': 'booth-draft'}, 'note': {'type': 'string'}, 'what': {'type': 'string'}, 'draft': {'type': 'object', 'required': ['draftId', 'slug', 'title', 'headline', 'subtext', 'cta', 'captureMode', 'language', 'palette', 'welcomePortraitUrl', 'welcomeLandscapeUrl', 'appBackgroundUrl', 'frameTags', 'filterMood', 'remainingFullGenerations', 'remainingRegens'], 'properties': {'cta': {'type': 'string'}, 'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'edited': {'type': 'array', 'items': {'type': 'string'}}, 'draftId': {'type': 'string'}, 'logoUrl': {'type': 'string'}, 'palette': {'type': 'object', 'required': ['backgroundColor', 'primaryColor', 'secondaryColor', 'dark'], 'properties': {'dark': {'type': 'boolean'}, 'primaryColor': {'type': 'string'}, 'secondaryColor': {'type': 'string'}, 'backgroundColor': {'type': 'string'}}, 'additionalProperties': False}, 'subtext': {'type': 'string'}, 'frameIds': {'type': 'array', 'items': {'type': 'string'}}, 'headline': {'type': 'string'}, 'language': {'type': 'string'}, 'settings': {'type': 'object', 'additionalProperties': {'type': 'object', 'additionalProperties': {'type': ['boolean', 'number', 'null']}}}, 'filterIds': {'type': 'array', 'items': {'type': 'string'}}, 'frameTags': {'type': 'array', 'items': {'type': 'string'}}, 'aiEffectId': {'type': 'string'}, 'filterMood': {'type': 'string'}, 'captureMode': {'type': 'string'}, 'regenerated': {'type': 'array', 'items': {'type': 'string'}}, 'remainingRegens': {'type': 'number'}, 'appBackgroundUrl': {'type': 'string'}, 'welcomePortraitUrl': {'type': 'string'}, 'welcomeLandscapeUrl': {'type': 'string'}, 'remainingFullGenerations': {'type': 'number'}}, 'additionalProperties': False}, 'error': {'type': 'string'}, 'jobId': {'type': 'string'}, 'state': {'type': 'string'}, 'draftId': {'type': 'string'}}, 'additionalProperties': False}
get_credits
Get AI credits and plan
This operator's remaining AI credit balance and their current subscription plan, including when it ends. Call this when they ask how many credits are left, whether they can still run AI effects, or what plan they are on. Credits are separate from wallet money — do not confuse the two.
읽기 전용 외부 접근 가능 멱등성
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['credits'], 'properties': {'plan': {'type': 'string', 'description': 'Subscription package name'}, 'credits': {'type': 'number', 'description': 'AI credits remaining. NOT money â\x80\x94 see get_wallet_transactions for that.'}, 'videoCredits': {'type': 'number'}, 'sessionCredits': {'type': 'number'}, 'subscriptionEndDate': {'type': ['string', 'null']}}, 'additionalProperties': False}
get_gallery_stats
Get gallery statistics
How much media this operator's booths have produced: total, still active, and expired past the retention window. Call this when the operator asks how many photos or videos a booth has taken, or whether media is being lost to retention. Returns counts only, not the media itself.
읽기 전용 외부 접근 가능 멱등성
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'projectId': {'type': 'string', 'description': 'Limit to one booth. Omit for every booth this operator owns.'}, 'includeExpired': {'type': 'boolean', 'description': 'Count media past its retention window too (default false)'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['totalCount'], 'properties': {'totalCount': {'type': 'number'}, 'activeCount': {'type': 'number', 'description': 'Still inside the retention window'}, 'expiredCount': {'type': 'number', 'description': 'Past retention and no longer downloadable'}}, 'additionalProperties': False}
get_project
Get one booth in detail
Full detail for a single booth: its name, public link, currency, screen size, and the live status of the device running it — whether it is online, when it was last seen, app version, and camera/printer/internet state. Call this when the operator asks about one specific booth, or whether a booth is working. Get the project id from list_projects first.
읽기 전용 외부 접근 가능 멱등성
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['projectId'], 'properties': {'projectId': {'type': 'string', 'description': 'Project id from list_projects'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['project', 'deviceCount', 'devices'], 'properties': {'devices': {'type': 'array', 'items': {'type': 'object', 'properties': {'camera': {'type': 'string'}, 'printer': {'type': 'string'}, 'closedAt': {'type': ['string', 'null']}, 'deviceId': {'type': 'string'}, 'internet': {'type': 'string'}, 'liveness': {'type': 'string'}, 'appVersion': {'type': 'string'}, 'diskFreeGB': {'type': 'number'}, 'lastSeenAt': {'type': 'string'}, 'closedReason': {'type': ['string', 'null']}, 'lastActivityAt': {'type': 'string'}, 'cpuUsagePercent': {'type': 'number'}, 'ramUsagePercent': {'type': 'number'}}, 'additionalProperties': False}, 'description': 'Empty when device monitoring is unavailable â\x80\x94 not an error'}, 'project': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'country': {'type': 'string'}, 'currency': {'type': 'string'}, 'isActive': {'type': 'boolean'}, 'isPublic': {'type': 'boolean'}, 'updatedAt': {'type': 'string'}, 'screenSize': {'type': 'object', 'properties': {'width': {'type': 'number'}, 'height': {'type': 'number'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'deviceCount': {'type': 'number'}}, 'additionalProperties': False}
get_revenue_summary
Get revenue summary
Business revenue from this operator's photobooth sessions across EVERY payment channel — gateway payments, cash vouchers (cash collected at the booth) and discount vouchers — grouped by month or day and by currency, with extra-print revenue and AI-effect purchases reported separately. Use this for any question about income, revenue or omzet. It is also the right tool when wallet earnings look too small: cash and voucher money never reaches the wallet ledger, so for operators who take cash the wallet figure legitimately understates income.
읽기 전용 외부 접근 가능 멱등성
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'description': 'End date, ISO YYYY-MM-DD. Omit for all time.'}, 'from': {'type': 'string', 'description': 'Start date, ISO YYYY-MM-DD. Omit for all time.'}, 'groupBy': {'enum': ['month', 'day'], 'type': 'string', 'description': 'Bucket size (default month)'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': ['string', 'null']}, 'from': {'type': ['string', 'null']}, 'found': {'type': 'boolean'}, 'source': {'type': 'string', 'description': 'Which ledger the figures came from'}, 'totals': {'type': 'array', 'items': {'type': 'object', 'properties': {'revenue': {'$ref': '#/properties/buckets/items/properties/revenue'}, 'currency': {'$ref': '#/properties/buckets/items/properties/currency'}, 'mainRevenue': {'$ref': '#/properties/buckets/items/properties/mainRevenue'}, 'paidSessions': {'$ref': '#/properties/buckets/items/properties/paidSessions'}, 'gatewayRevenue': {'$ref': '#/properties/buckets/items/properties/gatewayRevenue'}, 'reprintRevenue': {'$ref': '#/properties/buckets/items/properties/reprintRevenue'}, 'aiEffectRevenue': {'$ref': '#/properties/buckets/items/properties/aiEffectRevenue'}, 'cashVoucherRevenue': {'$ref': '#/properties/buckets/items/properties/cashVoucherRevenue'}, 'completedPaidSessions': {'$ref': '#/properties/buckets/items/properties/completedPaidSessions'}, 'discountVoucherRevenue': {'$ref': '#/properties/buckets/items/properties/discountVoucherRevenue'}}, 'additionalProperties': False}}, 'buckets': {'type': 'array', 'items': {'type': 'object', 'properties': {'period': {'type': 'string'}, 'revenue': {'type': 'number', 'description': 'main + reprint; the headline figure'}, 'currency': {'type': 'string'}, 'mainRevenue': {'type': 'number'}, 'paidSessions': {'type': 'number'}, 'gatewayRevenue': {'type': 'number'}, 'reprintRevenue': {'type': 'number'}, 'aiEffectRevenue': {'type': 'number', 'description': 'Counted separately, NOT inside revenue'}, 'cashVoucherRevenue': {'type': 'number'}, 'completedPaidSessions': {'type': 'number', 'description': 'Paid AND finished; the gap is money taken for sessions that never completed'}, 'discountVoucherRevenue': {'type': 'number'}}, 'additionalProperties': False}}, 'groupBy': {'type': 'string'}, 'mixedCurrency': {'type': 'boolean'}, 'reconciliation': {'type': 'object', 'properties': {'unaccounted': {'type': ['number', 'null']}, 'bucketedRevenue': {'type': 'number'}, 'lifetimeRevenue': {'type': ['number', 'null']}, 'coversLifetimeTotal': {'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}
get_sessions
Get photo sessions
List the photo sessions recorded on this operator's booths, with totals. Call this when the operator asks how busy a booth has been, how many sessions ran in a period, or wants to inspect individual sessions. Supports date ranges, per-booth filtering, payment status and payment channel. For money totals rather than session counts, use get_revenue_summary instead.
읽기 전용 외부 접근 가능 멱등성
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'How many sessions to return (default 20, max 100)'}, 'endDate': {'type': 'string', 'description': 'ISO date (YYYY-MM-DD) for the end of the range, inclusive'}, 'startDate': {'type': 'string', 'description': 'ISO date (YYYY-MM-DD) for the start of the range, inclusive'}, 'projectIds': {'type': 'string', 'description': 'Comma-separated project ids to limit the range to specific booths'}, 'paymentSource': {'type': 'string', 'description': 'Payment channel, e.g. gateway, cash-voucher, discount-voucher'}, 'sessionStatus': {'type': 'string', 'description': 'Session status filter'}, 'transactionStatus': {'type': 'string', 'description': 'Payment status filter, e.g. settlement, pending'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['returned', 'sessions'], 'properties': {'total': {'type': 'number', 'description': 'Sessions matching the filter, across all pages'}, 'returned': {'type': 'number', 'description': 'How many are in this response'}, 'sessions': {'type': 'array', 'items': {}}, 'totalPages': {'type': 'number'}}, 'additionalProperties': False}
get_wallet_transactions
Get wallet transactions
This operator's wallet ledger: gateway earnings, withdrawals and refunds, newest first. Use for questions about the wallet, payouts or withdrawals. Do NOT use it to answer 'how much did I earn' — the wallet excludes cash and voucher income entirely, so for operators who take cash it understates real revenue. Use get_revenue_summary for income.
읽기 전용 외부 접근 가능 멱등성
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'description': 'End date, ISO YYYY-MM-DD'}, 'from': {'type': 'string', 'description': 'Start date, ISO YYYY-MM-DD'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max rows (default 10)'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['returned', 'truncated', 'transactions'], 'properties': {'total': {'type': 'number', 'description': 'Rows matching the filter, across all pages'}, 'returned': {'type': 'number'}, 'truncated': {'type': 'boolean'}, 'transactions': {'type': 'array', 'items': {}}}, 'additionalProperties': False}
list_projects
List booths
List the photobooth projects this operator owns, with id, name, public link slug, whether it is active, and its currency. Call this first whenever the operator names a booth — you need the project id to filter any other tool by booth. Does not return booth designs or page layouts.
읽기 전용 외부 접근 가능 멱등성
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['count', 'projects'], 'properties': {'count': {'type': 'number'}, 'projects': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Pass this as projectId to other tools'}, 'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'country': {'type': 'string'}, 'currency': {'type': 'string'}, 'isActive': {'type': 'boolean'}, 'isPublic': {'type': 'boolean'}, 'updatedAt': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
preview_filter
Preview a photo filter
Show what a filter would look like BEFORE creating it: the Studio renders its sample photo (or the operator's own preview photo, if they set one in the dashboard) through the exact pipeline the booth uses, and returns an image URL. Free and read-only — call it whenever the operator is designing a filter, adjust the numbers from their reaction ('warmer', 'less contrast'), preview again, and call create_filter with the same adjustments only once they are happy. Some adjustments (shadows, highlights, whites, blacks, clarity, dehaze, vibrance, texture) are applied by the booth but cannot be shown here; the result lists them as notPreviewed so you can say so. Nothing is created by this tool.
읽기 전용 외부 접근 가능 멱등성
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['adjustments'], 'properties': {'adjustments': {'type': 'object', 'properties': {'blur': {'type': 'number', 'maximum': 10, 'minimum': 0, 'description': '0 = off, in pixels'}, 'tint': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged, positive = magenta'}, 'grain': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': '0 = off'}, 'sepia': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': '0 = off'}, 'blacks': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged'}, 'dehaze': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged'}, 'whites': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged'}, 'clarity': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged'}, 'shadows': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged, positive = lifted'}, 'contrast': {'type': 'number', 'maximum': 200, 'minimum': 0, 'description': '100 = unchanged'}, 'exposure': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged'}, 'vibrance': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged'}, 'vignette': {'type': 'number', 'maximum': 200, 'minimum': 0, 'description': '0 = off'}, 'grayscale': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': '0 = off, 100 = black and white'}, 'hueRotate': {'type': 'number', 'maximum': 360, 'minimum': 0, 'description': '0 = unchanged, in degrees'}, 'brightness': {'type': 'number', 'maximum': 200, 'minimum': 0, 'description': '100 = unchanged'}, 'highlights': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged'}, 'saturation': {'type': 'number', 'maximum': 200, 'minimum': 0, 'description': '100 = unchanged, 0 = grey'}, 'temperature': {'type': 'number', 'maximum': 100, 'minimum': -100, 'description': '0 = unchanged, positive = warmer'}}, 'description': 'Only include what the operator asked to change. An omitted adjustment keeps its neutral value; sending every field at its neutral value creates a filter that does nothing.', 'additionalProperties': False}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['kind', 'previewUrl', 'previewed', 'notPreviewed', 'sample', 'adjustments', 'note'], 'properties': {'kind': {'type': 'string', 'const': 'filter-preview'}, 'note': {'type': 'string'}, 'sample': {'type': 'string'}, 'previewed': {'type': 'array', 'items': {'type': 'string'}}, 'previewUrl': {'type': 'string'}, 'adjustments': {'type': 'object', 'additionalProperties': {'type': 'number'}}, 'notPreviewed': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}
refine_booth
Refine a booth draft
Change a booth draft from start_booth, using the draftId check_generation returned. what='welcome' redraws the welcome screen from an instruction ('warmer colours', 'bigger headline', 'less clutter') while keeping the design; add orientation 'phone' or 'laptop' to redraw only that screen (1 redraw) — without it both screens are redrawn (2). what='app-background' redraws the calmer backdrop behind the rest of the booth (1 redraw). what='everything' rebuilds the whole draft from a NEW full description (spends 1 of the draft's 3 full generations) — only when the operator wants a different booth, not a tweak. A draft has 5 redraws in total; check_generation reports what is left. Title, headline, link name and colours cannot be edited directly: they change only through a redraw instruction, or at create time (title, slug). Returns a job id; call check_generation. Call only when the operator asks for a change — never iterate on your own.
외부 접근 가능
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['draftId', 'what', 'instruction'], 'properties': {'what': {'enum': ['welcome', 'app-background', 'everything'], 'type': 'string', 'description': "Which part to change. 'everything' is a full rebuild from a new description."}, 'draftId': {'type': 'string', 'pattern': '^dft_[a-f0-9]{24}$', 'description': "The draft to change, from check_generation's result for start_booth."}, 'instruction': {'type': 'string', 'maxLength': 1000, 'minLength': 1, 'description': "For 'welcome' / 'app-background': what to change, in the operator's words, up to 300 characters â\x80\x94 the current design is kept and only this is applied. For 'everything': the new full description of the booth, up to 1000 characters."}, 'orientation': {'enum': ['phone', 'laptop'], 'type': 'string', 'description': "Only with what='welcome': redraw just the phone (portrait) or laptop (landscape) screen. Omit to redraw both."}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['kind', 'jobId', 'state', 'what'], 'properties': {'kind': {'type': 'string', 'const': 'booth-draft'}, 'note': {'type': 'string'}, 'what': {'type': 'string'}, 'error': {'type': 'string'}, 'jobId': {'type': 'string'}, 'state': {'type': 'string'}, 'draftId': {'type': 'string'}}, 'additionalProperties': False}
refine_frame
Refine a photo frame design
Ask for a changed version of a frame in an existing design thread — 'darker', 'less ornament', 'make the flowers smaller', 'more gold'. Call it with the threadId that check_generation returned for start_frame, and ONLY when the operator asks for a change: every call spends part of the account's free daily allowance, so never iterate on your own initiative. It returns immediately with a job id; call check_generation for the new preview. Earlier versions in the thread stay available to save_frame, so a change the operator dislikes loses nothing.
외부 접근 가능
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['threadId', 'prompt'], 'properties': {'prompt': {'type': 'string', 'maxLength': 4000, 'minLength': 1, 'description': "What to change, in the operator's words. It is read with the whole thread as context, so 'the same but darker' works; there is no need to repeat the original description."}, 'threadId': {'type': 'string', 'minLength': 1, 'description': "The design thread, from check_generation's result for start_frame."}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['kind', 'jobId', 'state', 'what'], 'properties': {'kind': {'type': 'string', 'const': 'generation'}, 'note': {'type': 'string'}, 'what': {'type': 'string'}, 'error': {'type': 'string'}, 'jobId': {'type': 'string'}, 'state': {'type': 'string'}, 'threadId': {'type': 'string'}}, 'additionalProperties': False}
save_frame
Save a generated frame
Save one generation from a design thread as a real frame in this operator's frame list, with its photo windows cut out. Call it only when the operator has chosen a result — pass the threadId and generationId that check_generation returned for it. This CREATES a frame: saving the same generation twice makes two frames, so do not retry a call that may have gone through. The frame is private to the account unless the operator explicitly asks for it to be shared. After saving, the operator picks the frame in a booth's frame settings; this tool does not assign it to a booth, and there is no tool that edits or deletes a frame.
외부 접근 가능
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['threadId', 'generationId'], 'properties': {'name': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': 'What the operator will see in their frame list. Use their words if they named it; otherwise derived from the description.'}, 'isPublic': {'type': 'boolean', 'description': 'Leave unset unless they explicitly ask to share it. Default is private to their account.'}, 'threadId': {'type': 'string', 'minLength': 1, 'description': 'The design thread the generation belongs to.'}, 'generationId': {'type': 'string', 'minLength': 1, 'description': 'The generation to save, from check_generation. Each version in a thread has its own id.'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['kind', 'state'], 'properties': {'kind': {'type': 'string', 'const': 'frame'}, 'name': {'type': 'string'}, 'state': {'type': 'string'}, 'frameId': {'type': 'string'}, 'isPublic': {'type': 'boolean'}, 'threadId': {'type': 'string'}, 'canvasWidth': {'type': 'number'}, 'canvasHeight': {'type': 'number'}, 'dashboardUrl': {'type': 'string'}, 'generationId': {'type': 'string'}, 'thumbnailUrl': {'type': 'string'}, 'placeholderCount': {'type': 'number'}}, 'additionalProperties': False}
search_docs
Search Dreambooth documentation
Search the Dreambooth Studio documentation and FAQ. Call this before answering any question about the product, pricing, packages, hardware, printing, subscriptions, or troubleshooting — answer from the docs rather than from memory. Works without a connected account.
읽기 전용 외부 접근 가능 멱등성
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max results (default 5)'}, 'query': {'type': 'string', 'minLength': 2, 'description': 'Search terms, in English or Indonesian'}, 'locale': {'enum': ['en', 'id'], 'type': 'string', 'description': 'Docs language (default en)'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['locale', 'query', 'resultCount', 'results'], 'properties': {'query': {'type': 'string'}, 'locale': {'type': 'string'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['excerpt'], 'properties': {'href': {'type': 'string'}, 'title': {'type': 'string'}, 'excerpt': {'type': 'string'}}, 'additionalProperties': False}}, 'resultCount': {'type': 'number'}}, 'additionalProperties': False}
start_booth
Design a new booth
Design a complete photobooth (a 'booth') for this operator from a description — the Studio designs the welcome screen for phone and laptop, the in-booth background, the colour theme, the capture mode, a title and a link name, exactly as dreambooth.app/new does. Before calling, gather in chat what /new would ask and put ALL of it in the prompt: the occasion or business, the vibe or style, colours, and the language the booth should speak — there is no separate questions step. It returns a job id immediately; call check_generation, and do NOT describe the booth as designed or created until that says done. The result is a DRAFT with a draftId: nothing is in the operator's booth list until create_booth. Every call makes a new draft and spends 1 of its 3 full generations, and an account may start 10 drafts an hour — never call it speculatively or twice for one request; change a draft with refine_booth instead.
외부 접근 가능
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['prompt'], 'properties': {'prompt': {'type': 'string', 'maxLength': 1000, 'minLength': 3, 'description': "The booth, in the operator's words plus what you gathered: occasion or business, vibe and style, colours, mood, anything that must appear. Up to 1000 characters. Do not name brands, characters or franchises; the image model refuses them."}, 'language': {'type': 'string', 'maxLength': 10, 'minLength': 2, 'description': "The language the booth's own text should be in, as a code: 'id', 'en', 'es'. Defaults to English â\x80\x94 ask if the operator's booth is not in English."}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['kind', 'jobId', 'state', 'what'], 'properties': {'kind': {'type': 'string', 'const': 'booth-draft'}, 'note': {'type': 'string'}, 'what': {'type': 'string'}, 'error': {'type': 'string'}, 'jobId': {'type': 'string'}, 'state': {'type': 'string'}}, 'additionalProperties': False}
start_frame
Start designing a photo frame
Start designing a new photo frame for this operator's booths from a description of the look they want — 'batik motifs in warm gold', 'minimal Scandinavian, lots of white space'. It opens a design thread and makes the FIRST version. It returns immediately with a job id; call check_generation to see the result, and do NOT describe the frame as made until that says so. The result is a preview in the thread — nothing is in the operator's frame list until save_frame is called with the generation they choose. To change a result, call refine_frame with the threadId that check_generation returns, rather than starting again. Every generation spends part of the account's free daily allowance, so do not call this speculatively, twice for the same request, or while another generation is still running.
외부 접근 가능
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['prompt', 'layout'], 'properties': {'shape': {'enum': ['rect', 'rounded', 'circle', 'oval', 'square'], 'type': 'string', 'description': 'The shape the photos are cut to. Defaults to rectangular. Not every layout comes in every shape; the Studio picks the closest available.'}, 'layout': {'enum': ['strip-3', 'strip-4', 'grid-4', 'hero-3', 'pair-2'], 'type': 'string', 'description': "How many photos and how they sit. 'strip-3': the classic photo strip â\x80\x94 3 photos stacked, printed as a pair on a 4x6; 'strip-4': a taller strip â\x80\x94 4 photos stacked, printed as a pair on a 4x6; 'grid-4': 4 photos in a 2x2 grid on one 4x6; 'hero-3': one large photo with two smaller ones beneath it; 'pair-2': two landscape photos, one above the other. Ask if it is not obvious from what the operator said; 'strip-3' is what most people mean by a photobooth strip."}, 'prompt': {'type': 'string', 'maxLength': 4000, 'minLength': 1, 'description': "What the frame should look like, in the operator's own words where possible: decoration, colour, mood, occasion. Not the photo slots â\x80\x94 those come from the layout. Do not name brands, characters or franchises; the image model refuses them."}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['kind', 'jobId', 'state', 'what'], 'properties': {'kind': {'type': 'string', 'const': 'generation'}, 'note': {'type': 'string'}, 'what': {'type': 'string'}, 'error': {'type': 'string'}, 'jobId': {'type': 'string'}, 'state': {'type': 'string'}}, 'additionalProperties': False}
update_booth_draft
Change a booth draft's settings
Change a booth draft without a redraw: its title, link name, welcome button text, colours, capture mode, language, which frames and filters it carries, its AI effect, and the page settings the dashboard editor offers (photo count, countdown, timeouts, GIF/recording, retake, checkout, payment, result). Use it after check_generation shows the draft and the operator asks for one of these; what it sets is applied when create_booth runs. It cannot change the welcome headline or subtext of an AI-designed welcome (those are painted into the image — use refine_booth), and prices or packages are set in the dashboard. Answers at once with the updated draft, `applied` (what landed) and `rejected` (what did not, and why) — relay a rejection as a sentence, never as success. It never touches a booth that already exists.
외부 접근 가능 멱등성
입력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['draftId'], 'properties': {'slug': {'type': 'string', 'pattern': '^[a-z0-9]+(?:-[a-z0-9]+)*$', 'maxLength': 44, 'minLength': 3, 'description': 'The proposed link name (dreambooth.app/<slug>): lowercase letters, digits, single hyphens. Checked for availability; a taken one is reported, not stored.'}, 'title': {'type': 'string', 'maxLength': 80, 'minLength': 2, 'description': "The booth's name (used as the title at create time)."}, 'draftId': {'type': 'string', 'pattern': '^dft_[a-f0-9]{24}$', 'description': 'The draft to change, from check_generation or get_booth_draft.'}, 'palette': {'type': 'object', 'properties': {'primaryColor': {'type': 'string', 'pattern': '^#[0-9a-fA-F]{6}$'}, 'secondaryColor': {'type': 'string', 'pattern': '^#[0-9a-fA-F]{6}$'}, 'backgroundColor': {'type': 'string', 'pattern': '^#[0-9a-fA-F]{6}$'}}, 'description': 'Theme colours as #RRGGBB: primaryColor, secondaryColor, backgroundColor. Only the ones given change.', 'additionalProperties': False}, 'subtext': {'type': 'string', 'maxLength': 140, 'minLength': 1, 'description': 'Welcome subtext; same rule as headline.'}, 'frameIds': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-f0-9]{24}$'}, 'maxItems': 20, 'description': "Frames the booth should carry (replaces the draft's list): e.g. one saved with save_frame, or catalogue ids. create_booth adds starter frames anyway."}, 'headline': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': 'Welcome headline. Only drafts whose welcome is laid out as text accept it; on an AI-designed welcome it is painted into the image and the reply says to use refine_booth.'}, 'language': {'type': 'string', 'maxLength': 10, 'minLength': 2, 'description': "Language code of the booth's own text: 'id', 'en', 'es'."}, 'settings': {'type': 'object', 'properties': {'frame': {'type': 'object', 'properties': {'displayFrameTitle': {'type': 'boolean'}}, 'additionalProperties': False}, 'filter': {'type': 'object', 'properties': {'enabled': {'type': 'boolean'}, 'useLivePreview': {'type': 'boolean'}, 'applyAfterCapture': {'type': 'boolean'}}, 'additionalProperties': False}, 'result': {'type': 'object', 'properties': {'emailEnabled': {'type': 'boolean'}, 'resultTimeout': {'type': 'integer', 'maximum': 600, 'minimum': 10}, 'askUserConsent': {'type': 'boolean'}, 'reprintEnabled': {'type': 'boolean'}, 'reprintTimeout': {'type': 'integer', 'maximum': 600, 'minimum': 10}}, 'additionalProperties': False}, 'retake': {'type': 'object', 'properties': {'enabled': {'type': 'boolean'}, 'retakeTimeout': {'type': 'integer', 'maximum': 600, 'minimum': 5}, 'maxRetakeCount': {'anyOf': [{'type': 'integer', 'maximum': 20, 'minimum': -1}, {'type': 'null'}]}, 'maxRetakeSession': {'anyOf': [{'type': 'integer', 'maximum': 20, 'minimum': -1}, {'type': 'null'}]}}, 'additionalProperties': False}, 'select': {'type': 'object', 'properties': {'enabled': {'type': 'boolean'}, 'selectionTimeout': {'type': 'integer', 'maximum': 600, 'minimum': 10}}, 'additionalProperties': False}, 'capture': {'type': 'object', 'properties': {'gifSpeed': {'type': 'integer', 'maximum': 5000, 'minimum': 200}, 'gifEnabled': {'type': 'boolean'}, 'prepTimeout': {'type': 'integer', 'maximum': 300, 'minimum': 5}, 'captureCount': {'type': 'integer', 'maximum': 10, 'minimum': 1}, 'captureTimeout': {'type': 'integer', 'maximum': 1800, 'minimum': 30}, 'recordingSpeed': {'type': 'integer', 'maximum': 4, 'minimum': 1}, 'captureCountdown': {'type': 'integer', 'maximum': 15, 'minimum': 1}, 'recordingEnabled': {'type': 'boolean'}, 'selfPhotoDuration': {'type': 'integer', 'maximum': 1800, 'minimum': 30}}, 'additionalProperties': False}, 'payment': {'type': 'object', 'properties': {'enabled': {'type': 'boolean'}, 'paymentTimeout': {'type': 'integer', 'maximum': 900, 'minimum': 30}}, 'additionalProperties': False}, 'welcome': {'type': 'object', 'properties': {'startWithPayment': {'type': 'boolean'}}, 'additionalProperties': False}, 'checkout': {'type': 'object', 'properties': {'enabled': {'type': 'boolean'}, 'promoEnabled': {'type': 'boolean'}, 'checkoutTimeout': {'type': 'integer', 'maximum': 600, 'minimum': 10}}, 'additionalProperties': False}}, 'description': 'Page settings, as the dashboard editor has them, keyed by page: welcome{startWithPayment}, capture{captureCount 1-10, captureCountdown 1-15, prepTimeout, captureTimeout, selfPhotoDuration, gifEnabled, gifSpeed, recordingEnabled, recordingSpeed}, retake{enabled, retakeTimeout, maxRetakeCount, maxRetakeSession}, select{enabled, selectionTimeout}, frame{displayFrameTitle}, filter{enabled, useLivePreview, applyAfterCapture}, checkout{enabled, checkoutTimeout, promoEnabled}, payment{enabled, paymentTimeout}, result{resultTimeout, askUserConsent, emailEnabled, reprintEnabled, reprintTimeout}. Prices and packages are set in the dashboard, not here.', 'additionalProperties': False}, 'filterIds': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-f0-9]{24}$'}, 'maxItems': 20, 'description': "Filters the booth should carry (replaces the draft's list): e.g. one made with create_filter. The default 'Normal' is added anyway."}, 'buttonText': {'type': 'string', 'maxLength': 32, 'minLength': 1, 'description': "The welcome screen's button label, e.g. 'Mulai' or 'Start'."}, 'captureMode': {'enum': ['standard', 'frame-based'], 'type': 'string', 'description': "'standard' = classic strip, 'frame-based' = frame mode."}, 'aiEffectTitle': {'type': 'string', 'maxLength': 80, 'description': 'The title of a public AI effect to add, exactly as the operator named it; an empty string removes the one chosen before.'}}, 'additionalProperties': False}
출력 스키마
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['kind', 'jobId', 'state', 'what', 'draftId'], 'properties': {'kind': {'type': 'string', 'const': 'booth-draft'}, 'note': {'type': 'string'}, 'what': {'type': 'string'}, 'draft': {'type': 'object', 'required': ['draftId', 'slug', 'title', 'headline', 'subtext', 'cta', 'captureMode', 'language', 'palette', 'welcomePortraitUrl', 'welcomeLandscapeUrl', 'appBackgroundUrl', 'frameTags', 'filterMood', 'remainingFullGenerations', 'remainingRegens'], 'properties': {'cta': {'type': 'string'}, 'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'edited': {'type': 'array', 'items': {'type': 'string'}}, 'draftId': {'type': 'string'}, 'logoUrl': {'type': 'string'}, 'palette': {'type': 'object', 'required': ['backgroundColor', 'primaryColor', 'secondaryColor', 'dark'], 'properties': {'dark': {'type': 'boolean'}, 'primaryColor': {'type': 'string'}, 'secondaryColor': {'type': 'string'}, 'backgroundColor': {'type': 'string'}}, 'additionalProperties': False}, 'subtext': {'type': 'string'}, 'frameIds': {'type': 'array', 'items': {'type': 'string'}}, 'headline': {'type': 'string'}, 'language': {'type': 'string'}, 'settings': {'type': 'object', 'additionalProperties': {'type': 'object', 'additionalProperties': {'type': ['boolean', 'number', 'null']}}}, 'filterIds': {'type': 'array', 'items': {'type': 'string'}}, 'frameTags': {'type': 'array', 'items': {'type': 'string'}}, 'aiEffectId': {'type': 'string'}, 'filterMood': {'type': 'string'}, 'captureMode': {'type': 'string'}, 'regenerated': {'type': 'array', 'items': {'type': 'string'}}, 'remainingRegens': {'type': 'number'}, 'appBackgroundUrl': {'type': 'string'}, 'welcomePortraitUrl': {'type': 'string'}, 'welcomeLandscapeUrl': {'type': 'string'}, 'remainingFullGenerations': {'type': 'number'}}, 'additionalProperties': False}, 'error': {'type': 'string'}, 'jobId': {'type': 'string'}, 'state': {'type': 'string'}, 'applied': {'type': 'array', 'items': {'type': 'string'}}, 'draftId': {'type': 'string'}, 'rejected': {'type': 'array', 'items': {'type': 'object', 'required': ['field', 'reason'], 'properties': {'field': {'type': 'string'}, 'reason': {'type': 'string'}}, 'additionalProperties': False}}, 'slugAvailable': {'type': 'boolean'}}, 'additionalProperties': False}
추가됨
update_booth_draft
2026년 9월 25일 3:02 AM
추가됨
get_booth_draft
2026년 9월 25일 3:02 AM
추가됨
create_booth
2026년 9월 25일 3:02 AM
추가됨
refine_booth
2026년 9월 25일 3:02 AM
추가됨
start_booth
2026년 9월 25일 3:02 AM
추가됨
preview_filter
2026년 9월 25일 3:02 AM
추가됨
save_frame
2026년 9월 25일 3:02 AM
추가됨
check_generation
2026년 9월 25일 3:02 AM
추가됨
refine_frame
2026년 9월 25일 3:02 AM
추가됨
start_frame
2026년 9월 25일 3:02 AM
추가됨
duplicate_project
2026년 9월 25일 3:02 AM
추가됨
create_filter
2026년 9월 25일 3:02 AM
추가됨
get_wallet_transactions
2026년 9월 17일 12:34 PM
추가됨
get_credits
2026년 9월 17일 12:34 PM
추가됨
get_revenue_summary
2026년 9월 17일 12:34 PM
추가됨
get_project
2026년 9월 17일 12:34 PM
추가됨
list_projects
2026년 9월 17일 12:34 PM
추가됨
search_docs
2026년 9월 17일 12:34 PM
추가됨
get_gallery_stats
2026년 9월 17일 12:34 PM
추가됨
get_sessions
2026년 9월 17일 12:34 PM
추가됨
connection_status
2026년 9월 17일 12:34 PM
추가됨
connect_account
2026년 9월 17일 12:34 PM