Skip to content

Publish a Model (Image) ​

Target Outcome ​

The image model passes protocol testing, is published to the intended scope, and returns an accessible image result or URL.

Applicable Roles ​

  • Model Provider

Before You Start ​

  • Prepare the model source, identifier, API credential, image endpoint, and a non-sensitive test prompt.
  • Confirm supported size, format, image count, synchronous or asynchronous behavior, billing, and limits.

Procedure ​

  1. From the platform home page, select My Models in the left navigation.
  2. Open My Publications. Use Public Models / Private Models to switch publication areas, or open Overview and My Aggregations when needed.
  3. Select Publish Model in the upper-right corner.
  4. Select a publication area:
    • Publish to Private Area makes the model visible only within the team or tenant and keeps it out of the public catalog.
    • Publish to Public Area lists the model in the public catalog for all tenants and allows independent pricing and rate limits.
  5. Select Publish to Public Area to open Step 1.

Choose the publication area

Step 1: Basic Information ​

  • Under Model Source / Meta-Model Information:
    • Select a meta-model, such as qwen-image-2.0.
    • Select a model source, such as Alibaba - China.
    • Enter the request URL, such as https://dashscope.aliyuncs.com.
    • Enter the API key in the protected field, such as sk-***.
    • Enter the exact upstream Model Source ID, such as qwen-image-2.0.

Model source and meta-model information

  • Confirm Image Model and select the correct subtype, such as Image Editing.

Confirm the model type

  • Under Request Headers, keep the default Authorization: Bearer <key> template and add only headers required by the upstream service.

Configure request headers

  • Under Model Parameters, select supported input modalities such as Text and Image and set the output modality to Image.

Configure model parameters

  • Under Supported Protocols and Default Parameters:
    • Select OpenAI-Images, run the connectivity test, and enter the endpoint.
    • Configure inputs such as Prompt, Image, Mask, N, Size, Response Format, User, Negative Prompt, Prompt Extend, and Watermark.
    • Select Synchronous or Asynchronous invocation.
    • Configure result parsing with Result Path, URL Extract Field, and Base64 Extract Field.

Test the official native protocol

  • Enter the public Custom Identifier and description.

Complete basic information

  • Select Publish Immediately or Scheduled Publication.

Choose the publication method

  • Select Next to open Step 2.

Step 2: Billing Configuration ​

  • Select Token Billing, Per-Image Billing, or Free.
  • For paid billing:
    • Enable Show Price Comparison when a reference price should be displayed.
    • Optionally enable tier configuration for context-based pricing.
    • Enable the image-count dimension and use n as the recognition field when billing per image.
    • Enter the sale price and optional original price.
    • Optionally configure a free quota, eligible-user count, and total amount.

Configure billing

  • Select Next to open Step 3.

Step 3: Rate-Limit Configuration ​

  • Select Enable Rate Limiting or Disabled.
  • Configure default RPM and TPM values, or set either limit to Unlimited.

Configure rate limits

  • Select Save Only or Submit for Review.

Parameter Reference - Image Model ​

FieldTypeExampleDescription
Meta-ModelSelectqwen-image-2.0Required; base meta-model
Model SourceSelectAlibaba - ChinaRequired; upstream Model Provider
Request URLURLhttps://dashscope.aliyuncs.comRequired; model-service base URL
API KeyPasswordsk-***Required; protected upstream credential
Model Source IDTextqwen-image-2.0Required; exact upstream model name
Model TypeSingle selectImage ModelRequired; model function
Model SubtypeSelectImage EditingRequired; image-model subtype
Request HeadersKey-value pairsAuthorization: Bearer <key>Optional; authentication and custom headers
Input ModalitiesMulti-selectText / ImageRequired; accepted input types
Output ModalityMulti-selectImageRequired; result type
Supported ProtocolMulti-selectOpenAI-ImagesRequired; test connectivity before continuing
EndpointURLhttps://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generationRequired; protocol endpoint
Input ParametersParameter listPrompt / Image / Mask / N / Size / Response Format / User / Negative Prompt / Prompt Extend / WatermarkOptional; protocol inputs and required-state settings
Invocation MethodSingle selectSynchronous / AsynchronousRequired; invocation behavior
Result PathTextoutput.choices[0].message.content[0].imageOptional; path to the result payload
URL Extract FieldTexturl or image_urlOptional; field containing the result URL
Base64 Extract FieldTextb64_jsonOptional; field containing Base64 image data
Custom IdentifierTextqwen-image-2.0Required; model identifier shown to users
DescriptionTextImage generation...Optional; model description
Publication MethodSingle selectImmediate / ScheduledRequired; publication time
Billing MethodSingle selectToken / Per Image / FreeRequired; billing method
Show Price ComparisonSwitchOn / OffOptional; displays an original reference price
Tier ConfigurationSwitchOn / OffOptional; context-based pricing tiers
Image CountSwitchOn / OffOptional; bills by generated-image count using n
Sale PriceNumber2 Credits/imageRequired for paid models
Original PriceNumber4 Credits/imageOptional; reference price
Free QuotaSwitchOn / OffOptional; configures free usage quota
Rate LimitingSingle selectEnabled / DisabledOptional; controls invocation limits
RPMNumber / Unlimited2 requests/minuteOptional; request limit per minute
TPMNumber / Unlimited100 tokens/minuteOptional; token limit per minute

Completion Checklist ​

Purpose: These are the exit criteria for the current feature task. Use them to decide whether the result is observable and reviewable and whether you can continue to the next step in the scenario. They do not repeat the procedure; if any item fails, follow the troubleshooting section below.

CheckPass Criteria
1Protocol connectivity passes and the model source and identifier are accurate.
2Publication or review status is correct.
3A controlled call returns an accessible image result and the call log is traceable.

Troubleshooting ​

SymptomCheck First
Protocol test failsEndpoint, credential, model identifier, request parameters, and source network access
The image cannot be openedResponse mapping, result URL lifetime, format, callback, and content policy

User Manual ​

Review complete My Models fields and publication-result validation