1. 创建 API Key

登录沐辰智图工坊，进入“个人中心 → API Key”，创建一枚密钥。

密钥以 pcc_live_ 开头，只在创建成功时完整显示一次。复制后保存在服务端环境变量或密钥管理服务中，不要写进网页、App、公开仓库或日志。

macOS 或 Linux：

                      export MUCHEN_API_KEY="pcc_live_xxxxxxxxxxxxxxxxxxxxxxxx"
                        export MUCHEN_API_BASE_URL="https://api.muchen.si"

PowerShell：

                      $env:MUCHEN_API_KEY = "pcc_live_xxxxxxxxxxxxxxxxxxxxxxxx"
                        $env:MUCHEN_API_BASE_URL = "https://api.muchen.si"

2. 检查账号和积分

                      curl "$MUCHEN_API_BASE_URL/v1/user" \
                        -H "Authorization: Bearer $MUCHEN_API_KEY"

正常响应会包含账号、积分和会员信息：

                      {
                        "id": "usr_xxx",
                        "email": "user@example.com",
                        "name": "User",
                        "role": "user",
                        "credits": 1200,
                        "membership": {
                        "level": "free",
                        "active": false,
                        "api_enabled": true,
                        "expires_at": null
                        }
                        }

所有会员等级都能使用开放 API。实际调用仍需要有效的 API Key、可用账号和足够积分。

3. 查看文本模型

                      curl "$MUCHEN_API_BASE_URL/v1/models" \
                        -H "Authorization: Bearer $MUCHEN_API_KEY"

从响应的 data[].id 中选一个模型名称。模型由后台维护，可能随时启用、停用或改名，调用前不要依赖写死的名称。

                      {
                        "object": "list",
                        "data": [
                        {
                        "id": "YOUR_MODEL_NAME",
                        "object": "model",
                        "owned_by": "muchen-ai"
                        }
                        ]
                        }

4. 发起第一次对话请求

把 YOUR_MODEL_NAME 换成上一步返回的 data[].id：

                      curl "$MUCHEN_API_BASE_URL/v1/chat/completions" \
                        -H "Authorization: Bearer $MUCHEN_API_KEY" \
                        -H "Content-Type: application/json" \
                        -d '{
                        "model": "YOUR_MODEL_NAME",
                        "messages": [
                        {"role": "user", "content": "用一句话介绍 沐辰智图工坊。"}
                        ],
                        "stream": false
                        }'

文本接口会把请求交给所选模型的上游服务，并原样返回上游响应。不同模型的响应字段可能略有差异，客户端应按该模型实际返回的格式处理。

每个已鉴权请求的响应头都带有 X-Request-Id。遇到问题时保留这个值，排查会快很多。