요청 파라미터와 JSON

AdditionalParameters와 ExtInfo는 무엇입니까?

기본 요청 필드로 표현되지 않는 모델별 옵션을 전달하는 필드입니다. 두 필드는 공통 별칭이 아니며, 위치와 자료형은 API 및 모델마다 다릅니다. 해당 엔진의 파라미터 표에서 객체인지 JSON 문자열인지 먼저 확인하십시오.

JSON 객체와 JSON 문자열은 어떻게 다릅니까?

객체는 키와 값을 구조로 전달하고, JSON 문자열은 그 구조를 문자열 안에 담습니다. 아래 두 값은 자료형이 다릅니다. 문서가 String을 요구하는 경우 객체를 그대로 전달하지 마십시오.

{"options": {"enabled": true}}

{"options": "{\"enabled\":true}"}

위 options는 자료형 비교를 위한 이름입니다. 실제 요청에는 해당 API에 정의된 필드명을 사용하십시오.

예제의 역슬래시와 따옴표는 왜 필요합니까?

문자열 안의 따옴표는 \", 역슬래시는 \\, 줄바꿈은 \n으로 표현합니다. 이는 주석이 아니라 JSON의 이스케이프 표기입니다. SDK나 JSON 직렬화 함수를 사용하면 필요한 문자를 자동으로 처리할 수 있습니다. 완성된 요청 본문에서 역슬래시를 일괄 삭제하지 마십시오.

JSON에 // 주석을 넣어도 됩니까?

표준 JSON은 // 또는 /* ... */ 주석을 허용하지 않습니다. 설명용 주석이 포함된 값을 요청할 때는 주석을 제거하고 JSON 문법을 검증하십시오. 문자열 안의 https://는 URL의 일부이므로 제거하지 마십시오.

JSON 문자열을 만들 때 직렬화는 몇 번 해야 합니까?

객체를 받는 필드는 객체로 유지합니다. JSON 문자열을 받는 필드는 내부 객체를 한 번 직렬화하여 문자열로 만든 뒤 요청 객체에 넣습니다. HTTP 요청 본문의 직렬화는 SDK 또는 HTTP 클라이언트의 JSON 옵션에 맡기십시오. 이미 직렬화된 문자열을 다시 직렬화하면 바깥 따옴표가 추가되어 API가 기대한 구조와 달라질 수 있습니다.

가사나 프롬프트의 줄바꿈은 어떻게 전달합니까?

프로그램에서는 줄바꿈이 포함된 문자열을 만들고 JSON 직렬화 함수를 사용하십시오. JSON 본문을 직접 작성할 때는 문자열 안의 줄바꿈을 \n으로 표현합니다. AdditionalParameters처럼 JSON 문자열이 중첩된 필드는 내부와 외부의 직렬화를 구분해야 합니다.

선택 필드는 빈 문자열이나 null로 넣어야 합니까?

값을 지정하지 않을 때는 해당 필드의 기본값과 생략 규칙을 확인하십시오. 생략, 빈 문자열, null은 서로 다른 값입니다. 문서에서 허용하지 않은 null이나 빈 값을 모든 선택 필드에 일괄 삽입하지 마십시오.