codai Studio API
The Studio API from codai — 1 operation(s) for studio.
The Studio API from codai — 1 operation(s) for studio.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/codai-ro:codai-ro-studio-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Codai Ro Studio API
version: '1'
description: 'Operations tagged Studio across 2 of this provider''s published API definitions: codai-ro-gateway-openapi.json, codai-ro-gateway-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://ai.codai.ro
description: Production
security:
- bearerAuth: []
tags:
- name: Studio
paths:
/v1/studio/quote:
get:
operationId: getStudioQuote
tags:
- Studio
summary: Quote a Studio action
description: Prices an action before running it with the same functions billing uses, and returns your spendable balance. Free; records no usage. `action` selects the price function; the other query fields are its parameters.
parameters:
- name: action
in: query
required: true
schema:
type: string
enum:
- video
- music
- render
- preview
- frames
- captions
- speech
- image
- name: seconds
in: query
required: false
schema:
type: number
minimum: 0
- name: resolution
in: query
required: false
schema:
type: string
enum:
- 720p
- 1080p
- name: audio
in: query
required: false
schema:
type: boolean
- name: quality
in: query
required: false
schema:
type: string
enum:
- draft
- final
- name: pages
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 60
- name: chars
in: query
required: false
schema:
type: integer
minimum: 1
- name: model
in: query
required: false
schema:
type: string
- name: n
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 4
responses:
'200':
description: The quote and your spendable balance (`balance_micro_eur` null and `sufficient` true for accounts the gate exempts).
content:
application/json:
schema:
$ref: '#/components/schemas/StudioQuote'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
servers:
- url: https://ai.codai.ro
description: Production
components:
responses:
Unauthorized:
description: Missing, malformed, revoked or paused API key.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
BadRequest:
description: Malformed body or query; `details` holds the flattened field errors.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
schemas:
Error:
type: object
required:
- error
properties:
error:
type: object
required:
- message
- type
- code
properties:
message:
type: string
description: Human-readable, provider names redacted.
type:
type: string
enum:
- invalid_request_error
- subscription_required
- rate_limit_error
- upstream_error
- server_error
code:
type: string
enum:
- bad_request
- invalid_api_key
- subscription_inactive
- forbidden
- not_found
- payload_too_large
- rate_limit_exceeded
- quota_exceeded
- upstream_error
- internal_error
- not_a_member
- lease_held
- seq_conflict
- host_offline
- host_timeout
- rules_refused
- search_unavailable
- task_not_confirmable
- slug_taken
- project_has_environments
- already_has_env
- not_enrollable
- not_byo
- invalid_transition
- already_member
- vm_per_dev_single_member
- last_owner
- insufficient_balance
- key_scope_forbidden
- assets_unavailable
- asset_not_found
- too_many_renders
- renders_unavailable
- timeline_too_long
- not_a_timeline
- invalid_cursor
- templates_unavailable
- url_blocked
- invalid_tokens
- unsupported_media
- kind_mismatch
- node_not_found
- invalid_pick
- duplicate_key
- unknown_var
- invalid_var_value
- unsupported_kind
- too_long
- stale
- not_supported_for_kind
- unsupported_format
- too_large
- not_implemented
- version_conflict
- settings_unavailable
- ai_label_required
- sandbox_concurrency_limit
- sandbox_busy
- sandbox_daily_limit
- invalid_ttl
- workspace_too_large
- sandbox_paused_limit
- sandbox_capacity
details:
description: Present on `bad_request` (flattened Zod field errors), `invalid_tokens` (`issues`) and `rules_refused` (`tool`, `rule_id`, `decision`). Other codes never forward details over HTTP.
type: object
additionalProperties: true
examples:
- error:
message: Invalid or missing API key.
type: invalid_request_error
code: invalid_api_key
StudioQuote:
type: object
required:
- object
- action
- quote_micro_usd
- quote_micro_eur
- balance_micro_eur
- sufficient
properties:
object:
type: string
const: studio.quote
action:
type: string
quote_micro_usd:
type: string
quote_micro_eur:
type: string
description: Price of the action in micro-EUR (wallet price, incl. FX and markup).
balance_micro_eur:
type:
- string
- 'null'
description: 'Spendable balance in micro-EUR: wallet minus compute reserve minus open holds.'
sufficient:
type: boolean
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: codai_…
description: A codai API key (`codai_` prefix). Ephemeral tokens from `POST /v1/tokens` are accepted only by the media surfaces matching their scope (`/v1/realtime`, `/v1/audio/*`, `/v1/embeddings`).
x-refined-from:
- codai-ro-gateway-openapi.json
- codai-ro-gateway-openapi.yml