> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnimux.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Public hosts only: console https://omnimux.ai/dashboard · API https://api.omnimux.ai · docs https://docs.omnimux.ai.
> Gateway auth is Authorization: Bearer sk-… on https://api.omnimux.ai/v1 (OpenAI-compatible Chat Completions and related paths).
> Discover pages from /llms.txt; full site dump /llms-full.txt; product skill /skill.md; docs search MCP /mcp. Prefer .md page URLs for Markdown.
> Default docs locale is en; zh mirrors the same relative paths. Do not invent model ids not present on live pricing or the complete API pages.

# 列出账户

> 列出账户 — 显式账号来源

仅返回指定来源。官方列表不创建 Zernio tenant、不执行 Zernio 同步。空数组表示查询成功但无账号，失败不能当作空列表。

`provider` 必填，仅允许 `tiktok_direct` 或 `zernio`，表示操作范围，不能改写已存来源。缺失或未知值返回 400 `invalid-provider`。

使用 OmniMux 用户 access token 和 `New-Api-User`，不是 `sk-` 密钥。同时检查 HTTP 状态和 `success`；部分上游错误仍返回 HTTP 200、`success:false`。

CLI 0.4.0：二进制安装执行 `omnimux update`，npm 安装执行 `npm install -g @omnimux/cli@0.4.0`，随后使用 `omnimux social accounts --provider zernio` 或 `--provider tiktok_direct`。已有脚本也必须更新。参见 [API 更新](/zh/updates#2026-09-07-social-provider-required)。


## OpenAPI

````yaml openapi/ops/publishing/list-accounts.json GET /api/social/v1/accounts
openapi: 3.1.0
info:
  title: OmniMux Publishing — List Accounts
  version: provider-isolation
servers:
  - url: https://omnimux.ai
security:
  - accessToken: []
    userId: []
paths:
  /api/social/v1/accounts:
    get:
      summary: List Accounts
      operationId: listAccounts
      parameters:
        - name: provider
          in: query
          required: true
          schema:
            type: string
            enum:
              - tiktok_direct
              - zernio
            description: >-
              Required expected source; never changes the stored account or post
              provider.
          example: zernio
      responses:
        '200':
          description: >-
            Check success before reading data. Generic upstream errors may use
            HTTP 200 with success:false.
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      success:
                        type: boolean
                        enum:
                          - true
                      data:
                        type: object
                        properties:
                          accounts:
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: integer
                                  format: int64
                                provider:
                                  type: string
                                  enum:
                                    - tiktok_direct
                                    - zernio
                                  description: >-
                                    Required expected source; never changes the
                                    stored account or post provider.
                                  example: zernio
                                platform:
                                  type: string
                                username:
                                  type: string
                                display_name:
                                  type: string
                                status:
                                  type: string
                              required:
                                - id
                                - provider
                                - platform
                                - status
                        required:
                          - accounts
                    required:
                      - success
                      - data
                  - type: object
                    properties:
                      success:
                        type: boolean
                        enum:
                          - false
                      message:
                        type: string
                      code:
                        type: string
                    required:
                      - success
                      - message
        '400':
          description: >-
            Missing/unknown provider or invalid request. invalid-provider
            identifies a missing or unknown source.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  message:
                    type: string
                  code:
                    type: string
                required:
                  - success
                  - message
        '401':
          description: Authentication required.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  message:
                    type: string
                  code:
                    type: string
                required:
                  - success
                  - message
        '402':
          description: >-
            Billing-related rejection where applicable; upstream failures may
            instead be wrapped as success:false.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  message:
                    type: string
                  code:
                    type: string
                required:
                  - success
                  - message
        '403':
          description: Account ownership or access denied.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  message:
                    type: string
                  code:
                    type: string
                required:
                  - success
                  - message
        '404':
          description: Account or post not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  message:
                    type: string
                  code:
                    type: string
                required:
                  - success
                  - message
        '503':
          description: Requested provider is disabled or not configured.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  message:
                    type: string
                  code:
                    type: string
                required:
                  - success
                  - message
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl --request GET \
              --url "https://omnimux.ai/api/social/v1/accounts?provider=zernio" \
              --header 'Authorization: Bearer <user-access-token>' \
              --header 'New-Api-User: <user-id>'
components:
  securitySchemes:
    accessToken:
      type: http
      scheme: bearer
      description: OmniMux user access token, not an sk- API key.
    userId:
      type: apiKey
      in: header
      name: New-Api-User
      description: Current authenticated user ID.

````