@@ -9646,6 +9646,80 @@ components:
96469646 - b64_json
96479647 - created
96489648 type: object
9649+ ImageGenerationProviderPreferences:
9650+ description: Provider routing preferences and provider-specific passthrough configuration.
9651+ example:
9652+ allow_fallbacks: false
9653+ only:
9654+ - google-ai-studio
9655+ properties:
9656+ allow_fallbacks:
9657+ description: >
9658+ Whether to allow backup providers to serve requests
9659+
9660+ - true: (default) when the primary provider (or your custom providers in "order") is unavailable, use the
9661+ next best provider.
9662+
9663+ - false: use only the primary/custom provider, and return the upstream error if it's unavailable.
9664+ nullable: true
9665+ type: boolean
9666+ ignore:
9667+ description: >-
9668+ List of provider slugs to ignore. If provided, this list is merged with your account-wide ignored provider
9669+ settings for this request.
9670+ example:
9671+ - openai
9672+ - anthropic
9673+ items:
9674+ anyOf:
9675+ - $ref: '#/components/schemas/ProviderName'
9676+ - type: string
9677+ nullable: true
9678+ type: array
9679+ only:
9680+ description: >-
9681+ List of provider slugs to allow. If provided, this list is merged with your account-wide allowed provider
9682+ settings for this request.
9683+ example:
9684+ - openai
9685+ - anthropic
9686+ items:
9687+ anyOf:
9688+ - $ref: '#/components/schemas/ProviderName'
9689+ - type: string
9690+ nullable: true
9691+ type: array
9692+ options:
9693+ allOf:
9694+ - $ref: '#/components/schemas/ProviderOptions'
9695+ - example:
9696+ black-forest-labs:
9697+ guidance: 3
9698+ steps: 40
9699+ order:
9700+ description: >-
9701+ An ordered list of provider slugs. The router will attempt to use the first provider in the subset of this
9702+ list that supports your requested model, and fall back to the next if it is unavailable. If no providers are
9703+ available, the request will fail with an error message.
9704+ example:
9705+ - openai
9706+ - anthropic
9707+ items:
9708+ anyOf:
9709+ - $ref: '#/components/schemas/ProviderName'
9710+ - type: string
9711+ nullable: true
9712+ type: array
9713+ sort:
9714+ anyOf:
9715+ - $ref: '#/components/schemas/ProviderSort'
9716+ - $ref: '#/components/schemas/ProviderSortConfig'
9717+ - nullable: true
9718+ description: >-
9719+ The sorting strategy to use for this request, if "order" is not specified. When set, no load balancing is
9720+ performed.
9721+ example: price
9722+ type: object
96499723 ImageGenerationRequest:
96509724 description: Image generation request input
96519725 example:
@@ -9722,16 +9796,7 @@ components:
97229796 minLength: 1
97239797 type: string
97249798 provider:
9725- description: Provider-specific passthrough configuration
9726- properties:
9727- options:
9728- allOf:
9729- - $ref: '#/components/schemas/ProviderOptions'
9730- - example:
9731- black-forest-labs:
9732- guidance: 3
9733- steps: 40
9734- type: object
9799+ $ref: '#/components/schemas/ImageGenerationProviderPreferences'
97359800 quality:
97369801 description: Rendering quality. Providers without a quality knob ignore this.
97379802 enum:
0 commit comments