Skip to content

Publish a Model (Speech) ​

Target Outcome ​

The speech model passes protocol testing, is published to the intended scope, and returns a playable or decodable audio result.

Applicable Roles ​

  • Model Provider

Before You Start ​

  • Prepare the model source, identifier, API credential, endpoint, and a non-sensitive audio or text sample.
  • Confirm language, voice, format, sample rate, 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 qwen3-tts-flash.
    • 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 qwen3-tts-flash.

Model source and meta-model information

  • Confirm Speech Model and select the correct subtype, such as Text to Speech.

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, set the input modality to Text and the output modality to Audio.

Configure model parameters

  • Under Supported Protocols and Default Parameters:
    • Select OpenAI-Audio, run the connectivity test, and enter the endpoint.
    • Configure inputs such as Text, Voice, Language, Audio Format, Sample Rate, Volume, Speech Rate, Pitch, and Seed.
    • 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 Character Billing or Free.
  • For character billing:
    • Enable Show Price Comparison when a reference price should be displayed.
    • Enter the input sale price and optional original price in Credits per 1M characters.
    • 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 - Speech Model ​

FieldTypeExampleDescription
Meta-ModelSelectqwen3-tts-flashRequired; 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 IDTextqwen3-tts-flashRequired; exact upstream model name
Model TypeSingle selectSpeech ModelRequired; model function
Model SubtypeSelectText to SpeechRequired; speech-model subtype
Request HeadersKey-value pairsAuthorization: Bearer <key>Optional; authentication and custom headers
Input ModalityMulti-selectTextRequired; accepted input type
Output ModalityMulti-selectAudioRequired; result type
Supported ProtocolMulti-selectOpenAI-AudioRequired; test connectivity before continuing
EndpointURLhttps://dashscope.aliyuncs.com/api/v1/services/audio/tts/SpeechSynthesizerRequired; protocol endpoint
Input ParametersParameter listText / Voice / Language / Audio Format / Sample Rate / Volume / Speech Rate / Pitch / SeedOptional; protocol inputs and required-state settings
Invocation MethodSingle selectSynchronous / AsynchronousRequired; invocation behavior
Result PathTextdata.audio or response.output.resultsOptional; path to the result payload
URL Extract FieldTexturl or audio_urlOptional; field containing the result URL
Base64 Extract FieldTextb64_audioOptional; field containing Base64 audio data
Custom IdentifierTextqwen3-tts-flashRequired; model identifier shown to users
DescriptionTextText to speech...Optional; model description
Publication MethodSingle selectImmediate / ScheduledRequired; publication time
Billing MethodSingle selectPer Character / FreeRequired; billing method
Show Price ComparisonSwitchOn / OffOptional; displays an original reference price
Input Sale PriceNumber8 Credits/1M charactersRequired for paid models
Original PriceNumber16 Credits/1M charactersOptional; character 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 language, voice, and format settings are accurate.
2Publication or review status is correct.
3A controlled call returns playable audio and the call log is traceable.

Troubleshooting ​

SymptomCheck First
Protocol test failsEndpoint, credential, model identifier, audio encoding, and request body
Audio cannot be playedResponse mapping, Content-Type, sample rate, format, and result URL

User Manual ​

Review complete My Models fields and publication-result validation