바이너리 이미지 업로드 확인

준비된 mediaImport 업로드 설명자를 원본 JPEG, PNG 또는 WebP 바이트로 확인하세요. 최대 크기는 3,145,728바이트입니다. 바이트 길이와 SHA-256은 설명자와 일치해야 합니다. 파일 참조나 더 큰 로컬 파일에는 문서에 안내된 미디어 도구 및 SDK 멀티파트 절차를 사용하세요.

POST/api/v1/media/import

인증

AuthorizationBearer 토큰 · header필수

Influence의 범위 지정 API 키 또는 지원되는 OAuth 접근 토큰입니다. 인증 정보는 URL과 도구 입력에 넣지 마세요.

헤더 매개변수

X-Publish-ConfirmationConfirmationCapability필수

prepare에서 반환된 정확한 confirmationCapability입니다. expiresAt 전에 동일한 입력과 함께 이 헤더로만 보내세요.

최소 길이: 32 · 최대 길이: 4096 · 일치 패턴: ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKey필수

호출자가 생성한 재시도 식별자입니다. 응답이 불확실해도 이 키, 확인 권한 값 및 입력을 유지하세요.

최소 길이: 16 · 최대 길이: 200 · 일치 패턴: ^[A-Za-z0-9._:-]+$

X-Publish-Uploadstring필수

준비된 mediaImport 입력의 encodeURIComponent(JSON.stringify(upload)) 값입니다. 디코딩한 객체는 BinaryUploadDescriptor를 따르며 인코딩된 헤더는 최대 4,096자입니다.

최대 길이: 4096

요청 본문

필수application/octet-stream

string<binary>

응답

200

미디어 결과입니다. ok와 자산 상태를 확인하세요.

다음 중 하나만:

object

okboolean필수

outputJsonValue | null필수

속성 보기

다음 중 하나 이상:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

JsonValue 배열

JsonValue에 대한 순환 참조입니다.

object

object

toolNamestring필수

허용 값:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobject필수

속성 보기

codestring필수

허용 값:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestring필수

최소 길이: 1 · 최대 길이: 2048

retryableboolean필수

okboolean필수

toolNamestring필수

400

잘못된 요청입니다. 쿼리 매개변수는 받지 않습니다. 도구 유효성 검사 실패는 도구 오류 응답 형식으로 반환될 수 있습니다.

다음 중 하나 이상:

TransportError

errorobject필수

속성 보기

codestring필수

messagestring필수

retryableboolean필수

ToolError

errorobject필수

속성 보기

codestring필수

허용 값:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestring필수

최소 길이: 1 · 최대 길이: 2048

retryableboolean필수

okboolean필수

toolNamestring필수

401

bearer 인증 정보가 없거나 유효하지 않거나 만료되었습니다.

errorobject필수

속성 보기

codestring필수

messagestring필수

retryableboolean필수

403

인증 정보에 필요한 권한이 없습니다.

errorobject필수

속성 보기

codestring필수

messagestring필수

retryableboolean필수

404

머신 API 또는 요청한 도구를 사용할 수 없습니다.

errorobject필수

속성 보기

codestring필수

messagestring필수

retryableboolean필수

413

요청이 바이트 한도를 초과했습니다.

errorobject필수

속성 보기

codestring필수

허용 값:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestring필수

최소 길이: 1 · 최대 길이: 2048

retryableboolean필수

okboolean필수

toolNamestring필수

429

요청 빈도 제한을 초과했습니다. 재시도할 수 있는 오류입니다.

errorobject필수

속성 보기

codestring필수

messagestring필수

retryableboolean필수

503

API 또는 업스트림 실행을 이용할 수 없습니다.

errorobject필수

속성 보기

codestring필수

messagestring필수

retryableboolean필수

요청

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",
)

응답

{
  "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
  }
}