Skip to content

docs(model-api): sync generated references with the public catalog - #37

Merged
liyangbing merged 1 commit into
mainfrom
codex/docs-catalog-sync
Oct 13, 2026
Merged

liyangbing merged 1 commit into
mainfrom
codex/docs-catalog-sync

Conversation

@liyangbing

Copy link
Copy Markdown
Contributor

Summary

  • Generator hides models the public catalog hides (name contains 0622 or tagged protocol-ingress-only, mirroring sandbase-apiserver/internal/service/model.go). exp0622 and *-official duplicates are no longer generated; official models remain on the hand-written official-native-api pages.
  • Removes generated LLM/image/video/audio pages for disabled or deleted models (989) and Platform API orphans (126), plus 28 moved-page aliases whose target no longer exists.
  • Keeps per-call Platform API price notes in scripts/platform-api-price-notes.json (98 published APIs) and appends them to descriptions, since registry descriptions no longer carry them.
  • Required fields are always present in generated examples; SEO descriptions capped at 170 chars; internal hash suffixes gone.
  • Regenerated from sandbase-registry main (a6f0d274).
  • Replaced the retired kling-video/3.0/turbo example with kwaivgi/kling-video/v3/standard/text-to-video.

Tested

  • Page sets equal live /v1/pricing/models: 116 LLM, 102 image, 169 video, 30 audio, 965 API (tiktok/web/live-room stays excluded as before).
  • npm run validate passes; generator tests 27/27 (two were already failing on main and are fixed here).

Not included

Hand-written API reference fixes from the audit (volcengine list/delete, Session inline agent/stream, rate-limit messages, /events/webhooks) will follow separately.

- Hide models the public catalog hides (name contains 0622 or tagged
  protocol-ingress-only), so exp0622 and *-official duplicates are not
  generated; official models stay on the hand-written native pages.
- Remove generated LLM/image/video/audio pages for models that are
  disabled or gone, plus moved-page aliases whose target no longer exists.
- Keep per-call Platform API price notes in
  scripts/platform-api-price-notes.json and append them to descriptions.
- Always include required fields in generated examples; cap SEO
  descriptions at 170 characters.
- Regenerate from sandbase-registry main (a6f0d274); pages now match
  /v1/pricing/models (116 LLM, 102 image, 169 video, 30 audio, 965 API).
- Replace the retired Kling 3.0 Turbo example model and update stale
  validator/test fixtures.
@liyangbing
liyangbing merged commit 823ce53 into main Oct 13, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant