> ## 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.

# 媒体预签名

> 媒体预签名

* 社媒 **发布** 用户 API（非 `sk-` 社交数据读）
* Base：`https://omnimux.ai`；鉴权 access token + `New-Api-User`
* 连接账户命名对齐 Zernio **Connecting Accounts**

## 身份

| 字段 | 值    |
| -- | ---- |
| 系列 | 社媒发布 |
| 能力 | 申请上传 |

## 接口

| 方法     | 路径                             |
| ------ | ------------------------------ |
| `POST` | `/api/social/v1/media/presign` |

Base URL：`https://omnimux.ai`

## 鉴权

| 名称              | 位置     | 类型     | 必填 | 说明                                       |
| --------------- | ------ | ------ | -- | ---------------------------------------- |
| `Authorization` | header | string | 是  | `Bearer <access_token>`（用户 access token） |
| `New-Api-User`  | header | string | 是  | 当前用户 id                                  |

## 请求体 / 参数

以右栏 cURL 为准。常见字段：

| 字段    | 类型 | 必填 | 说明                     |
| ----- | -- | -- | ---------------------- |
| （见示例） | —  | —  | 不同资源（连接 / 帖子 / 媒体）字段不同 |

## 响应

### 200

| 字段        | 类型      | 说明   |
| --------- | ------- | ---- |
| `success` | boolean | 是否成功 |
| `data`    | object  | 业务数据 |

错误见右栏与 [错误码](/zh/faqs/connection-usage)。

<Panel>
  <RequestExample>
    ```bash cURL theme={null}
    curl --request POST \
      --url https://omnimux.ai/api/social/v1/media/presign \
      --header 'Authorization: Bearer <access_token>' \
      --header 'New-Api-User: <user_id>' \
      --header 'Content-Type: application/json' \
      --data '{"filename":"a.png","contentType":"image/png"}'
    ```
  </RequestExample>

  <ResponseExample>
    ```json 200 theme={null}
    {"success":true,"data":{"upload_url":"https://...","public_url":"https://..."}}
    ```

    ```json 401 theme={null}
    {
      "success": false,
      "message": "Unauthorized"
    }
    ```

    ```json 402 theme={null}
    {
      "success": false,
      "message": "Insufficient quota. Please top up your account."
    }
    ```

    ```json 403 theme={null}
    {
      "success": false,
      "message": "Forbidden"
    }
    ```

    ```json 404 theme={null}
    {
      "success": false,
      "message": "Not found"
    }
    ```

    ```json 429 theme={null}
    {
      "success": false,
      "message": "Rate limit exceeded"
    }
    ```

    ```json 500 theme={null}
    {
      "success": false,
      "message": "Internal server error"
    }
    ```
  </ResponseExample>
</Panel>