이미지 임베딩
| 항목 | 값 |
|---|---|
| 화면 이름 | Image to embeddings |
| 식별자 | imageToEmbeddingsV1 |
| 지원 실행 방식 | Batch |
| 범주 | 미디어 (Media) |
| 반환 자료형 | Embedded vector |
지정한 모델로 이미지를 임베딩으로 변환합니다.
입력 인자
| 이름 | 지정 여부 | 자료형 | 의미와 조건 |
|---|---|---|---|
Media reference | 필수 | Expression<Media reference> | 임베딩으로 변환할 이미지 미디어 참조 열입니다. |
Model | 필수 | Model | 변환에 사용할 임베딩 모델입니다. 시각 입력 기능을 지원해야 합니다. |
Output mode | 선택 | Enum<Simple, With errors> | 출력만 반환하거나 구조체로 반환할지 선택합니다. 구조체는 결과를 ok, 오류를 errors 필드에 담습니다. |
입출력 예시
예시 1: 기본 동작
이미지 임베딩의 예시입니다.
인자 값:
Media reference:mediaRefModel:
googleSiglip2Embedding(
)Output mode: null
| mediaRef | 출력 |
|---|---|
| { "mimeType": "image/jpeg", "reference": { "type": "mediaSetViewItem", "... | embeddings-result |
예시 2: null 처리
null 입력은 null을 반환합니다.
인자 값:
Media reference:mediaRefModel:
googleSiglip2Embedding(
)Output mode: null
| mediaRef | 출력 |
|---|---|
| null | null |
긴 구조값 안의 줄임표는 생략한 내용을 나타냅니다.