Studio Custom Domain and Launch Acceptance

This article migrates Studio from the system domain to its own page domain and completes the read-only acceptance before the official launch.

Completion Effect

Customers can access through a self-owned domain like https://studio.zhishuyun.com, HTTPS is valid, the page runs with the correct branding, and login and main AI capabilities are available.

Preparation Before Starting

  • Ability to modify the public DNS of the target domain;
  • Branding, login, capabilities, and pricing configurations have been completed on the system domain;
  • The target hostname has no conflicting A, AAAA, or CNAME records;
  • Entered the target substation by clicking Manage in the official Studio's "My Substation".

Step 1: Bind Domain in Substation

  1. Open Custom Domain in the substation settings;
  2. Enter the full hostname, such as studio.zhishuyun.com;
  3. Do not include https://, paths, or trailing slashes;
  4. Click bind;
  5. Copy the CNAME requirements displayed on the page at that time.

Studio Custom Domain: Online Domain and Binding Entry

The CNAME target may change with infrastructure adjustments, refer to what is currently displayed in the console, do not copy old screenshots or historical values from tutorials.

Step 2: Configure Public DNS

Add the records required by the console to the DNS provider:

Field How to Fill
Type CNAME
Host Record Prefix corresponding to the target hostname, such as studio
Record Value Current CNAME target displayed in the console
TTL Default value of the DNS provider

After saving, use a public DNS query tool to check the external results, do not only look at the "Saved" status in the DNS console.

Step 3: Verify and Wait for HTTPS

  1. Return to the substation's "Custom Domain";
  2. Click the verification/refresh operation provided on the page;
  3. Wait for the status to change to online;
  4. Open the official domain using HTTPS;
  5. Check the hostname and validity period of the certificate.

DNS propagation and HTTPS certificate issuance are two phases, and the timing may differ. Do not promise completion within a fixed number of minutes.

Step 4: Acceptance According to Official Launch Standards

Complete in a new incognito window:

  1. Open and refresh the homepage on both desktop and mobile;
  2. Check the title, Logo, Favicon, theme, language, and customer service;
  3. Register or log in to a test account, confirm completion, and return to the official domain;
  4. Open a chat capability and execute a low-cost request;
  5. Open a live image or video capability, confirm the ability to create and query tasks;
  6. Check pricing, purchase entry, and quota changes;
  7. Check the title, description, canonical, OG, and favicon after the page runs;
  8. Record whether the original HTML or share preview still displays a unified product shell.

Current Boundaries

  • "Online" only indicates that the current DNS/TLS/HTTP probe has passed, it does not prove that the hostname necessarily points to the expected proxy; it is still necessary to open the page from the public network, refresh deep routing, and complete the login redirect; this also does not mean that the account, balance, or token has been isolated by domain;
  • The branding of Studio's page mainly loads after the client runs, the original HTML/without JavaScript client may still display a unified product shell;
  • Generated assets may continue to use public CDN.

Success Indicators

  • Public DNS returns the CNAME required by the console;
  • No certificate warnings for HTTPS;
  • Desktop and mobile pages are accessible and have no horizontal overflow;
  • Login, redirect, refresh, and main capabilities are normal;
  • Customer service links are accessible;
  • The team has recorded the current boundaries of raw HTML/share preview.

Frequently Asked Questions

Domain Verification Always Fails

Check if the hostname is filled in completely, whether there are conflicting A/AAAA records in DNS, and whether the public DNS has been updated.

HTTPS Not Ready

First confirm that the CNAME has taken effect on the public network, then wait for the certificate issuance. If it remains unchanged for a long time, provide the domain, verification time, and status screenshot, do not provide passwords or tokens.

Browser Correct but Share Preview Still Shows Unified Branding

First confirm whether the crawler executes JavaScript. Studio currently guarantees branding after running; use the original HTML, User-Agent, domain, and time as evidence of the issue.

Next Article

If you want to sell APIs to developers, continue reading Building API Platform from 0 to 1; if only operating Studio, you can directly read the customer and revenue sections.