Auto REST API 참조(베타)

Note

자동은 애플리케이션 프로필이 Auto에 대해 사용하도록 설정된 외부 파트너에 대해 베타로 제공됩니다. API 표면 및 계약이 변경될 수 있습니다.

끝점:POST https://api.microsoft.ai/v3/auto

모든 요청에는 API 키 또는 Microsoft Entra ID 액세스 토큰이 필요합니다. 설치 지침은 인증 을 참조하세요.

샘플 요청

curl -X POST "https://api.microsoft.ai/v3/auto" \
  -H "x-apikey: <Your API key>" \
  -H "content-type: application/json" \
  -d '{
    "query": "Microsoft AI announcements",
    "language": "en",
    "region": "US",
    "location": "lat:47.6062;long:-122.3321",
    "mode": "fast",
    "maxResponseLength": 30000,
    "responseFilter": ["web", "news"]
  }'

Parameters

매개 변수 Required Type Default Description
query Yes string - 쿼리를 1~1,000자까지 검색합니다. 지원 및 -site: 연산자 site: 입니다.
language No string en 두 문자 ISO 639-1 인터페이스 언어입니다.
region No string US 두 글자 시장 또는 국가/지역 코드입니다.
mode No string fast fast 속도 우선 순위 지정; advanced 은 포괄적인 우선 순위를 지정합니다.
maxResponseLength No integer 30000 최대 총 응답 길이입니다. 1500 미만의 값은 1500으로 고정됩니다. 500000을 초과하는 값은 5000000으로 고정됩니다.
location No string - 형식의 lat:<latitude>;long:<longitude> 지리적 컨텍스트(예 lat:47.6062;long:-122.3321: .)
responseFilter No 문자열 배열 - 적격 답변 유형: web, news, weathertimezone, images. videos

응답

성공적인 증거 응답이 반환됩니다 200 OK. 각 결과에는 하나의 형식화된 증거 개체와 이를 지원하는 인용이 포함됩니다. 지원되지 않거나 형식이 잘못된 증거는 인용과 함께 생략됩니다. 제공된 모든 증거 결과를 생략 results 하면 비어 있습니다.

AutoEvidenceResponse

Field Type Description
results AutoEvidenceResult의 배열 해당 결과로 범위가 지정된 인용과 쌍을 이루는 증거 항목입니다.
traceId string 디버깅 및 지원을 위한 상관 관계 ID입니다.

AutoEvidenceResult

Field Type Description
evidence AutoEvidence 생성된 형식화된 증명 정보입니다.
citations AutoEvidenceCitation의 배열 이 증거 결과만 지원하는 인용입니다.

AutoEvidence

Evidence 개체의 판 type 별자가 스키마 content를 선택합니다.

type content
text 웹 및 뉴스 결과에 대해 반환된 문자열 증거입니다.
media/image 이미지 결과 개체입니다.
media/video 비디오 결과 개체입니다.
structured/weather 날씨 개체입니다.
structured/timeZone 표준 시간대 개체입니다.

뉴스 텍스트 증거에 thumbnail 는 with url, width및 height. 구조적 콘텐츠는 해당 검색 답변과 동일한 공용 필드 표시 유형 규칙을 따릅니다.

AutoEvidenceCitation

Field Type Description
contentSource string 인용 원본입니다.
title string 인용 제목입니다.
url string 인용 URL입니다.
lastUpdatedAt string 마지막으로 업데이트된 타임스탬프입니다.
crawledAt string 크롤링 타임스탬프입니다.
language string 콘텐츠 언어입니다.
isAdult 부울 인용에 성인 콘텐츠가 포함되어 있는지 여부입니다.

응답 예제

{
  "results": [
    {
      "evidence": {
        "type": "text",
        "content": "Microsoft announced a new set of AI capabilities."
      },
      "citations": [
        {
          "contentSource": "web",
          "url": "https://www.microsoft.com/en-us/ai",
          "title": "Microsoft AI",
          "language": "en",
          "isAdult": false
        }
      ]
    }
  ],
  "traceId": "00000000000000000000000000000000"
}

오류 코드

상태 코드 Description
200 결과가 없는 유효한 검색을 포함하여 요청이 성공했습니다.
400 잘못된 매개 변수 또는 잘못된 형식의 JSON입니다.
401 인증 자격 증명이 없거나 잘못되었습니다.
403 인증된 프로필은 자동에서 사용할 수 없습니다.
429 속도 또는 할당량 한도를 초과했습니다.
500 내부 서비스 오류입니다.
503 필요한 서비스를 사용할 수 없습니다.
504 요청 시간이 초과되었습니다.

공유 오류 스키마 및 다시 시도 지침은 오류 처리를 참조하세요.

관련 콘텐츠

  • 에 마지막으로 업데이트됨