Xác nhận tải ảnh nhị phân lên

Xác nhận bộ mô tả tải lên mediaImport đã chuẩn bị bằng đúng các byte JPEG, PNG hoặc WebP gốc (tối đa 3.145.728 byte). Độ dài tính bằng byte và SHA-256 phải khớp bộ mô tả. Với tham chiếu tệp hoặc tệp cục bộ lớn hơn, dùng công cụ tệp đa phương tiện và quy trình multipart của SDK theo tài liệu.

POST/api/v1/media/import

Ủy quyền

AuthorizationToken Bearer · headerbắt buộc

Khóa API Influence có phạm vi quyền cụ thể hoặc token truy cập OAuth được hỗ trợ. Không đưa thông tin xác thực vào URL hay đầu vào công cụ.

Tham số tiêu đề

X-Publish-ConfirmationConfirmationCapabilitybắt buộc

Giá trị confirmationCapability chính xác do prepare trả về. Chỉ gửi trong tiêu đề này, với cùng đầu vào, trước expiresAt.

độ dài tối thiểu 32 · độ dài tối đa 4096 · khớp ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeybắt buộc

Mã định danh do bên gọi tạo để dùng khi thử lại. Giữ nguyên khóa này, giá trị confirmationCapability và đầu vào sau phản hồi chưa rõ kết quả.

độ dài tối thiểu 16 · độ dài tối đa 200 · khớp ^[A-Za-z0-9._:-]+$

X-Publish-Uploadstringbắt buộc

encodeURIComponent(JSON.stringify(upload)) từ đầu vào mediaImport đã chuẩn bị. Đối tượng sau khi giải mã tuân theo BinaryUploadDescriptor; tiêu đề đã mã hóa dài tối đa 4.096 ký tự.

độ dài tối đa 4096

Nội dung yêu cầu

bắt buộcapplication/octet-stream

string<binary>

Các phản hồi

200

Kết quả tệp đa phương tiện; kiểm tra ok và trạng thái tài nguyên.

Đúng một phương án:

object

okbooleanbắt buộc

outputJsonValue | nullbắt buộc

Hiện thuộc tính

Ít nhất một phương án:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

Mảng gồm JsonValue

Tham chiếu vòng đến JsonValue.

object

object

toolNamestringbắt buộc

Cho phép:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobjectbắt buộc

Hiện thuộc tính

codestringbắt buộc

Cho phép:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringbắt buộc

độ dài tối thiểu 1 · độ dài tối đa 2048

retryablebooleanbắt buộc

okbooleanbắt buộc

toolNamestringbắt buộc

400

Yêu cầu không hợp lệ. Không chấp nhận tham số truy vấn. Lỗi kiểm tra dữ liệu của công cụ có thể dùng cấu trúc phản hồi lỗi của công cụ.

Ít nhất một phương án:

TransportError

errorobjectbắt buộc

Hiện thuộc tính

codestringbắt buộc

messagestringbắt buộc

retryablebooleanbắt buộc

ToolError

errorobjectbắt buộc

Hiện thuộc tính

codestringbắt buộc

Cho phép:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringbắt buộc

độ dài tối thiểu 1 · độ dài tối đa 2048

retryablebooleanbắt buộc

okbooleanbắt buộc

toolNamestringbắt buộc

401

Thông tin xác thực Bearer bị thiếu, không hợp lệ hoặc hết hạn.

errorobjectbắt buộc

Hiện thuộc tính

codestringbắt buộc

messagestringbắt buộc

retryablebooleanbắt buộc

403

Thông tin xác thực thiếu các quyền cần thiết.

errorobjectbắt buộc

Hiện thuộc tính

codestringbắt buộc

messagestringbắt buộc

retryablebooleanbắt buộc

404

API dành cho máy hoặc công cụ được yêu cầu không khả dụng.

errorobjectbắt buộc

Hiện thuộc tính

codestringbắt buộc

messagestringbắt buộc

retryablebooleanbắt buộc

413

Yêu cầu vượt giới hạn byte.

errorobjectbắt buộc

Hiện thuộc tính

codestringbắt buộc

Cho phép:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringbắt buộc

độ dài tối thiểu 1 · độ dài tối đa 2048

retryablebooleanbắt buộc

okbooleanbắt buộc

toolNamestringbắt buộc

429

Vượt giới hạn tần suất. Có thể thử lại khi gặp lỗi này.

errorobjectbắt buộc

Hiện thuộc tính

codestringbắt buộc

messagestringbắt buộc

retryablebooleanbắt buộc

503

API hoặc quá trình thực thi phía sau API không khả dụng.

errorobjectbắt buộc

Hiện thuộc tính

codestringbắt buộc

messagestringbắt buộc

retryablebooleanbắt buộc

Yêu cầu

curl -X POST 'https://influence.so/api/v1/media/import' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Publish-Confirmation: stringstringstringstringstringst' \
  -H 'Idempotency-Key: stringstringstri' \
  -H 'X-Publish-Upload: string' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/octet-stream' \
  -d 'string'

const response = await fetch("https://influence.so/api/v1/media/import", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "X-Publish-Confirmation": "stringstringstringstringstringst",
    "Idempotency-Key": "stringstringstri",
    "X-Publish-Upload": "string",
    "Accept": "application/json",
    "Content-Type": "application/octet-stream"
  },
  body: "string"
});

import requests

response = requests.post(
    "https://influence.so/api/v1/media/import",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "X-Publish-Confirmation": "stringstringstringstringstringst",
        "Idempotency-Key": "stringstringstri",
        "X-Publish-Upload": "string",
        "Accept": "application/json",
        "Content-Type": "application/octet-stream"
    },
    data="string",
)

Phản hồi

{
  "ok": true,
  "output": "string",
  "toolName": "adAuditQuote"
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "AI_SCHEDULING_LIMIT_REACHED",
    "message": "string",
    "retryable": true
  },
  "ok": false,
  "toolName": "adAuditQuote"
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}