Skip to content

sync(openai): update docs to match upstream Docs repo (size/billing + Chinese text fixes)#91

Closed
Copilot wants to merge 5 commits intomainfrom
copilot/sync-openai-docs-updates
Closed

sync(openai): update docs to match upstream Docs repo (size/billing + Chinese text fixes)#91
Copilot wants to merge 5 commits intomainfrom
copilot/sync-openai-docs-updates

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 30, 2026

Syncs openai/ documentation with AceDataCloud/Docs@7097ba1 changes. Two categories of fixes:

gpt-image-2 size/billing model (generations + edits)

The previous docs incorrectly stated only 15 predefined sizes were accepted. Updated to reflect actual behavior:

  • size accepts any WIDTHxHEIGHT format (not just the table presets); auto/empty selects default
  • Billing is two-tier regardless of source image resolution:
    • 1K standard: table 1K sizes + upstream output aliases 1254x1254, 1672x941, 941x1672
    • Other (1.5×): any size outside the 1K set, including 2K/4K presets and custom dimensions
  • Added upstream hard constraints: dimensions must be multiples of 16, long edge ≤ 3840, total pixels ≤ 8,294,400
  • Added note: 1K-tier output may not match requested dimensions exactly (e.g. 1024x10241254x1254); re-using that as size stays at 1K rate

Chinese text in English chat completions guide

Several sections of openai_chat_completion_api_integration_guide.md contained untranslated Chinese:

  • Visual Model Python example prompt: "这张图片里有什么?""What's in this image?"
  • Visual Model response content field: translated to English
  • GPT-4o Drawing Model response example: translated to English
  • Error Handling descriptions and "获取失败" error message → "fetch failed"

Copilot AI and others added 4 commits April 30, 2026 05:55
…ource

- images_generations: replace "only 15 sizes" with WIDTHxHEIGHT format
  acceptance, add two billing tiers with 1K upstream aliases
  (1254x1254, 1672x941, 941x1672), upstream hard constraints
  (multiples of 16, long edge ≤ 3840, total pixels ≤ 8,294,400),
  and note that 1K-tier output may not be pixel-aligned
- images_edits: same size/billing updates; replace old "only 15 sizes"
  wording and simplify the example blockquote to reference "other" tier

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Co-authored-by: Germey <8678661+Germey@users.noreply.github.com>
- Split run-on sentence for 1K alias note in generations guide
- Break semicolon-chain in edits guide example blockquote into sentences

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Co-authored-by: Germey <8678661+Germey@users.noreply.github.com>
Copilot AI changed the title [WIP] Sync openai API documentation with upstream changes sync(openai): update docs to match upstream Docs repo (size/billing + Chinese text fixes) Apr 30, 2026
Copilot AI requested a review from Germey April 30, 2026 06:01
@acedatacloud-dev
Copy link
Copy Markdown
Member

Auto-closed during PR backlog cleanup: superseded sync (+24/-14) — content covered by next dispatch against current Docs. Root cause was a broken auto-merge in sync-from-docs.yml (now fixed in PR #143). The fix lands a pre-cleanup step + reliable completion signal so future dispatches will not leak PRs. If this PR contained content not yet in main, the next docs-updated dispatch will re-create it via the working pipeline.

@acedatacloud-dev acedatacloud-dev deleted the copilot/sync-openai-docs-updates branch May 5, 2026 07:23
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.

sync: update from Docs (7097ba1 docs: sync from PlatformBackend (zh-CN base + translations) [automated])

3 participants