List Models
Returns all models available to the authenticated organization.
/v1/modelsAuthorizationBearer token · headerrequiredAuthentication via Bearer token API key
List available models
dataModel[]requiredShow propertiesHide properties
ModelbillingModelBillingrequiredShow propertiesHide properties
kindstringrequiredfixed_creditunitstringrequiredOperation-specific pricing_credits are debited once per generated output.
credits_per_outputcurrencystringrequiredUSDkindstringrequiredtoken_usagepricing_modelstringrequiredtoken_usage_v1ratesobjectrequiredShow propertiesHide properties
cache_writeintegerrequiredcached_inputintegerrequiredinputintegerrequiredoutputintegerrequiredunitstringrequiredmillicents_per_million_tokenscontext_lengthintegercreatedintegerrequireddescriptionstringidstringrequiredinput_modalitiesstring[]max_output_lengthintegernamestringobjectstringrequiredmodeloutput_modalitiesstring[]owned_bystringrequiredpricingobjectdeprecatedDeprecated. Prefer pricing_credits for operation-specific debits per generated output. USD strings are legacy placeholders.
Show propertiesHide properties
svg_animatestringdeprecatedDeprecated — use pricing_credits. Legacy USD price string per generated animated SVG for an SVG animation operation.
svg_editstringdeprecatedDeprecated — use pricing_credits. Legacy USD price string per generated SVG for an SVG edit operation.
svg_generatestringrequireddeprecatedDeprecated — use pricing_credits. Legacy USD price string per generated SVG for an SVG generation operation.
svg_vectorizestringrequireddeprecatedDeprecated — use pricing_credits. Legacy USD price string per generated SVG for an SVG vectorization operation.
pricing_creditsobjectShow propertiesHide properties
svg_animateintegerCredits debited from the organization balance per generated animated SVG for this model's SVG animation operation.
svg_editintegerCredits debited from the organization balance per generated SVG for this model's SVG edit operation.
svg_generateintegerrequiredCredits debited from the organization balance per generated SVG for this model's SVG generation operation.
svg_vectorizeintegerrequiredCredits debited from the organization balance per generated SVG for this model's SVG vectorization operation.
supported_operationsstring[]supported_sampling_parametersstring[]Sampling controls supported by this model on native SVG generation and vectorization. An empty list means omit these fields entirely, including default and null values. Responses has separate sampling rules.
objectstringrequiredlistBad request – malformed body, missing required fields, or invalid parameter values.
codestringrequiredinvalid_requestinvalid_api_keyunauthorizedfunding_payment_failedfunding_payment_method_requiredfunding_payment_action_requiredfunding_pendinginsufficient_creditsaccount_frozencontent_policy_violationmodel_not_foundpayload_too_largerequest_timeoutrate_limit_exceededoperation_rate_limit_exceededweekly_limit_exceededserver_errormodel_errormodel_unavailablemessagestringrequiredparamstringThe request parameter the failure is about, as a path from the request body root: size.width, input[0].content. A parameter name, never a submitted value. The same field, with the same meaning, as param on the Open Responses error payload, so one name reads across a failure raised before streaming and one raised during it. Absent, rather than null, when the failure is not about one particular parameter.
request_idstringrequiredretry_afterintegerstatusintegerrequiredUnauthorized – missing, malformed, revoked, otherwise invalid API credentials, or an organization that could not be resolved for billing.
codestringrequiredinvalid_requestinvalid_api_keyunauthorizedfunding_payment_failedfunding_payment_method_requiredfunding_payment_action_requiredfunding_pendinginsufficient_creditsaccount_frozencontent_policy_violationmodel_not_foundpayload_too_largerequest_timeoutrate_limit_exceededoperation_rate_limit_exceededweekly_limit_exceededserver_errormodel_errormodel_unavailablemessagestringrequiredparamstringThe request parameter the failure is about, as a path from the request body root: size.width, input[0].content. A parameter name, never a submitted value. The same field, with the same meaning, as param on the Open Responses error payload, so one name reads across a failure raised before streaming and one raised during it. Absent, rather than null, when the failure is not about one particular parameter.
request_idstringrequiredretry_afterintegerstatusintegerrequiredPayment required – the organization has insufficient credits, or a funding payment has not settled.
codestringrequiredinvalid_requestinvalid_api_keyunauthorizedfunding_payment_failedfunding_payment_method_requiredfunding_payment_action_requiredfunding_pendinginsufficient_creditsaccount_frozencontent_policy_violationmodel_not_foundpayload_too_largerequest_timeoutrate_limit_exceededoperation_rate_limit_exceededweekly_limit_exceededserver_errormodel_errormodel_unavailablemessagestringrequiredparamstringThe request parameter the failure is about, as a path from the request body root: size.width, input[0].content. A parameter name, never a submitted value. The same field, with the same meaning, as param on the Open Responses error payload, so one name reads across a failure raised before streaming and one raised during it. Absent, rather than null, when the failure is not about one particular parameter.
request_idstringrequiredretry_afterintegerstatusintegerrequiredForbidden – the account is frozen, the request is not allowed, or content policy rejected the request.
codestringrequiredinvalid_requestinvalid_api_keyunauthorizedfunding_payment_failedfunding_payment_method_requiredfunding_payment_action_requiredfunding_pendinginsufficient_creditsaccount_frozencontent_policy_violationmodel_not_foundpayload_too_largerequest_timeoutrate_limit_exceededoperation_rate_limit_exceededweekly_limit_exceededserver_errormodel_errormodel_unavailablemessagestringrequiredparamstringThe request parameter the failure is about, as a path from the request body root: size.width, input[0].content. A parameter name, never a submitted value. The same field, with the same meaning, as param on the Open Responses error payload, so one name reads across a failure raised before streaming and one raised during it. Absent, rather than null, when the failure is not about one particular parameter.
request_idstringrequiredretry_afterintegerstatusintegerrequiredRequest timeout – the request exceeded an allowed client-facing deadline.
codestringrequiredinvalid_requestinvalid_api_keyunauthorizedfunding_payment_failedfunding_payment_method_requiredfunding_payment_action_requiredfunding_pendinginsufficient_creditsaccount_frozencontent_policy_violationmodel_not_foundpayload_too_largerequest_timeoutrate_limit_exceededoperation_rate_limit_exceededweekly_limit_exceededserver_errormodel_errormodel_unavailablemessagestringrequiredparamstringThe request parameter the failure is about, as a path from the request body root: size.width, input[0].content. A parameter name, never a submitted value. The same field, with the same meaning, as param on the Open Responses error payload, so one name reads across a failure raised before streaming and one raised during it. Absent, rather than null, when the failure is not about one particular parameter.
request_idstringrequiredretry_afterintegerstatusintegerrequiredPayload too large – the submitted prompt, image, or SVG input is too large.
codestringrequiredinvalid_requestinvalid_api_keyunauthorizedfunding_payment_failedfunding_payment_method_requiredfunding_payment_action_requiredfunding_pendinginsufficient_creditsaccount_frozencontent_policy_violationmodel_not_foundpayload_too_largerequest_timeoutrate_limit_exceededoperation_rate_limit_exceededweekly_limit_exceededserver_errormodel_errormodel_unavailablemessagestringrequiredparamstringThe request parameter the failure is about, as a path from the request body root: size.width, input[0].content. A parameter name, never a submitted value. The same field, with the same meaning, as param on the Open Responses error payload, so one name reads across a failure raised before streaming and one raised during it. Absent, rather than null, when the failure is not about one particular parameter.
request_idstringrequiredretry_afterintegerstatusintegerrequiredRate limit exceeded – request throughput or measured input/output token usage exhausted a binding ceiling. operation_rate_limit_exceeded identifies operation throughput; rate_limit_exceeded covers overall request and token rates. X-RateLimit-Dimension names the exact dimension. When Retry-After is present, retry after the indicated period.
codestringrequiredinvalid_requestinvalid_api_keyunauthorizedfunding_payment_failedfunding_payment_method_requiredfunding_payment_action_requiredfunding_pendinginsufficient_creditsaccount_frozencontent_policy_violationmodel_not_foundpayload_too_largerequest_timeoutrate_limit_exceededoperation_rate_limit_exceededweekly_limit_exceededserver_errormodel_errormodel_unavailablemessagestringrequiredparamstringThe request parameter the failure is about, as a path from the request body root: size.width, input[0].content. A parameter name, never a submitted value. The same field, with the same meaning, as param on the Open Responses error payload, so one name reads across a failure raised before streaming and one raised during it. Absent, rather than null, when the failure is not about one particular parameter.
request_idstringrequiredretry_afterintegerstatusintegerrequiredThe request could not be completed. Please retry.
codestringrequiredinvalid_requestinvalid_api_keyunauthorizedfunding_payment_failedfunding_payment_method_requiredfunding_payment_action_requiredfunding_pendinginsufficient_creditsaccount_frozencontent_policy_violationmodel_not_foundpayload_too_largerequest_timeoutrate_limit_exceededoperation_rate_limit_exceededweekly_limit_exceededserver_errormodel_errormodel_unavailablemessagestringrequiredparamstringThe request parameter the failure is about, as a path from the request body root: size.width, input[0].content. A parameter name, never a submitted value. The same field, with the same meaning, as param on the Open Responses error payload, so one name reads across a failure raised before streaming and one raised during it. Absent, rather than null, when the failure is not about one particular parameter.
request_idstringrequiredretry_afterintegerstatusintegerrequiredBad gateway – model execution returned an invalid or failed response.
codestringrequiredinvalid_requestinvalid_api_keyunauthorizedfunding_payment_failedfunding_payment_method_requiredfunding_payment_action_requiredfunding_pendinginsufficient_creditsaccount_frozencontent_policy_violationmodel_not_foundpayload_too_largerequest_timeoutrate_limit_exceededoperation_rate_limit_exceededweekly_limit_exceededserver_errormodel_errormodel_unavailablemessagestringrequiredparamstringThe request parameter the failure is about, as a path from the request body root: size.width, input[0].content. A parameter name, never a submitted value. The same field, with the same meaning, as param on the Open Responses error payload, so one name reads across a failure raised before streaming and one raised during it. Absent, rather than null, when the failure is not about one particular parameter.
request_idstringrequiredretry_afterintegerstatusintegerrequiredService unavailable – model execution is temporarily unavailable.
codestringrequiredinvalid_requestinvalid_api_keyunauthorizedfunding_payment_failedfunding_payment_method_requiredfunding_payment_action_requiredfunding_pendinginsufficient_creditsaccount_frozencontent_policy_violationmodel_not_foundpayload_too_largerequest_timeoutrate_limit_exceededoperation_rate_limit_exceededweekly_limit_exceededserver_errormodel_errormodel_unavailablemessagestringrequiredparamstringThe request parameter the failure is about, as a path from the request body root: size.width, input[0].content. A parameter name, never a submitted value. The same field, with the same meaning, as param on the Open Responses error payload, so one name reads across a failure raised before streaming and one raised during it. Absent, rather than null, when the failure is not about one particular parameter.
request_idstringrequiredretry_afterintegerstatusintegerrequiredGateway timeout – model execution exceeded the server deadline.
codestringrequiredinvalid_requestinvalid_api_keyunauthorizedfunding_payment_failedfunding_payment_method_requiredfunding_payment_action_requiredfunding_pendinginsufficient_creditsaccount_frozencontent_policy_violationmodel_not_foundpayload_too_largerequest_timeoutrate_limit_exceededoperation_rate_limit_exceededweekly_limit_exceededserver_errormodel_errormodel_unavailablemessagestringrequiredparamstringThe request parameter the failure is about, as a path from the request body root: size.width, input[0].content. A parameter name, never a submitted value. The same field, with the same meaning, as param on the Open Responses error payload, so one name reads across a failure raised before streaming and one raised during it. Absent, rather than null, when the failure is not about one particular parameter.
request_idstringrequiredretry_afterintegerstatusintegerrequired