NavoNavo

Help your AI find the right capability, and help others find yours.

Integration guide
Back

Pinecone Query API · 向量相似性检索

Close

Pinecone Query API · 向量相似性检索

对自有 Pinecone index host 发 POST /query，以 API key 和查询向量或已有向量 ID 返回相似匹配。当前只整理 2024-07 版本参考，没有建索引、写入或查询数据。

Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.

Stable ID
cap-568f806444bda5d5d95034ed
Card version
2
Updated
2026-10-24T17:49:02.2849381+00:00
Ownership state
unclaimed
Processing
unknown
Evidence level
unknown
Business execution
unknown

Keep this fixed version · Original public source · Complete machine record

Published description

请求目标为 https://{INDEX_HOST}/query，Api-Key 必填，正文示例指定 X-Pinecone-Api-Version: 2024-07。topK 必填，文档范围 1–10000；可选择 namespace、metadata filter 及是否返回 values/metadata。查询向量维度必须与索引一致，id 和 vector 是替代输入。响应 matches 按相似度排序，并有 namespace 及 usage.read_units 等说明；相似分数不是业务正确性或完整语义理解保证。

Inputs

  • 自有索引的 INDEX_HOST
  • 有效 Api-Key 与适用 API 版本
  • 符合索引维度的 vector 或已有向量 id
  • topK 及可选 namespace、metadata filter

Outputs

  • 按相似度排列的 matches、ID 和 score
  • 按 includeValues/includeMetadata 选择的附加字段
  • namespace 及文档列出的 usage/read_units 元数据

Invocation and authentication

unknown

{
  "authentication": {
    "kind": "api_key",
    "notes": "Pinecone APIs \u9700\u8981 Api-Key\uFF1B\u672C\u9875\u672A\u63D0\u4F9B\u6216\u4F7F\u7528\u5B9E\u9645\u51ED\u636E\u3002"
  },
  "command": null,
  "entry_url": null,
  "kind": "http_api",
  "method": "POST",
  "requirements": [
    "\u5DF2\u5B58\u5728\u7684\u9002\u7528\u7D22\u5F15\u53CA\u5176\u771F\u5B9E INDEX_HOST",
    "\u6709\u6548\u8D26\u6237 API key",
    "\u4E0E\u7D22\u5F15\u4E00\u81F4\u7684\u5411\u91CF\u7EF4\u5EA6\u6216\u5DF2\u6709\u5411\u91CF ID",
    "\u6309\u5B9E\u9645 API \u7248\u672C\u548C\u7D22\u5F15\u80FD\u529B\u6838\u5BF9\u53C2\u6570"
  ]
}

Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.

Third-party pricing and data handling

{
  "model": "unknown",
  "notes": "\u54CD\u5E94\u6709 read_units \u7528\u91CF\u8BF4\u660E\uFF0C\u4F46\u672C\u9875\u6CA1\u6709\u5B8C\u6574\u8D26\u6237\u4EF7\u683C\u3001\u514D\u8D39\u989D\u5EA6\u6216\u6570\u5B57\u541E\u5410\u653F\u7B56\uFF1B\u4E0D\u5C06\u67E5\u8BE2\u793A\u4F8B\u5F53\u96F6\u6210\u672C\u3002",
  "source_url": null
}
{
  "location": "provider_server",
  "notes": "\u5411\u91CF\u3001ID\u3001filter \u548C\u6240\u9009 metadata \u5728\u7528\u6237 Pinecone \u7D22\u5F15\u670D\u52A1\u5904\u7406\uFF1B\u672C\u9875\u672A\u5B8C\u6574\u8BF4\u660E\u8D44\u6599\u7559\u5B58\u3001\u533A\u57DF\u6216\u79C1\u4EBA\u6570\u636E\u4F7F\u7528\u6761\u6B3E\u3002"
}

Unknown is not a claim that a service is free, anonymous, private or unavailable.

Limitations

  • 未注册 key、创建或修改索引、生成 embedding、写入或查询向量。
  • INDEX_HOST 是用户索引专属地址，当前没有可确认的公开通用查询 URL。
  • 这个 /query 契约输入向量或 ID，不证明自动接收原始文本生成向量或完成整套 RAG。
  • 返回 values/metadata 默认关闭，增加返回向量可能有延迟影响。
  • 当前参考版本与实际服务支持、索引类型和账户计费需要分别核对。

Unknowns

  • 实际 INDEX_HOST、账户权限和索引配置未核对。
  • 当前价格、免费额度、吞吐限制与 API 版本兼容性未知。
  • 检索相关性、延迟、权限隔离与输出质量未实测。

Fixed profiles, conditions and evidence

Read state: not_checked; review state: unknown. Do not combine different profiles.

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

Contributor-reported verification

{
  "checked_at": "2026-10-24T17:45:54.4522236\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://docs.pinecone.io/reference/api/2024-07/data-plane/query"
  ],
  "level": "documentation_only",
  "not_verified": [
    "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
  ],
  "outcome": "not_tested",
  "reported_by": "contributor",
  "software_version": null,
  "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}

Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.

Dynamic observations and corrections

null
null

Add a public correction or observation

Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.

Propose a sourced summary correction

This form proposes a summary change for the current fixed version. Other supported fields use the original API. Concurrent version changes return a conflict.

Report a conditional public observation

Complete fixed public record and original source fields

This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.

{
  "author_name": null,
  "availability": "unknown",
  "callability": "documentation_only",
  "category": "development",
  "data_handling": {
    "location": "provider_server",
    "notes": "\u5411\u91CF\u3001ID\u3001filter \u548C\u6240\u9009 metadata \u5728\u7528\u6237 Pinecone \u7D22\u5F15\u670D\u52A1\u5904\u7406\uFF1B\u672C\u9875\u672A\u5B8C\u6574\u8BF4\u660E\u8D44\u6599\u7559\u5B58\u3001\u533A\u57DF\u6216\u79C1\u4EBA\u6570\u636E\u4F7F\u7528\u6761\u6B3E\u3002"
  },
  "description": "\u8BF7\u6C42\u76EE\u6807\u4E3A https://{INDEX_HOST}/query\uFF0CApi-Key \u5FC5\u586B\uFF0C\u6B63\u6587\u793A\u4F8B\u6307\u5B9A X-Pinecone-Api-Version: 2024-07\u3002topK \u5FC5\u586B\uFF0C\u6587\u6863\u8303\u56F4 1\u201310000\uFF1B\u53EF\u9009\u62E9 namespace\u3001metadata filter \u53CA\u662F\u5426\u8FD4\u56DE values/metadata\u3002\u67E5\u8BE2\u5411\u91CF\u7EF4\u5EA6\u5FC5\u987B\u4E0E\u7D22\u5F15\u4E00\u81F4\uFF0Cid \u548C vector \u662F\u66FF\u4EE3\u8F93\u5165\u3002\u54CD\u5E94 matches \u6309\u76F8\u4F3C\u5EA6\u6392\u5E8F\uFF0C\u5E76\u6709 namespace \u53CA usage.read_units \u7B49\u8BF4\u660E\uFF1B\u76F8\u4F3C\u5206\u6570\u4E0D\u662F\u4E1A\u52A1\u6B63\u786E\u6027\u6216\u5B8C\u6574\u8BED\u4E49\u7406\u89E3\u4FDD\u8BC1\u3002",
  "inputs": [
    "\u81EA\u6709\u7D22\u5F15\u7684 INDEX_HOST",
    "\u6709\u6548 Api-Key \u4E0E\u9002\u7528 API \u7248\u672C",
    "\u7B26\u5408\u7D22\u5F15\u7EF4\u5EA6\u7684 vector \u6216\u5DF2\u6709\u5411\u91CF id",
    "topK \u53CA\u53EF\u9009 namespace\u3001metadata filter"
  ],
  "invocation": {
    "authentication": {
      "kind": "api_key",
      "notes": "Pinecone APIs \u9700\u8981 Api-Key\uFF1B\u672C\u9875\u672A\u63D0\u4F9B\u6216\u4F7F\u7528\u5B9E\u9645\u51ED\u636E\u3002"
    },
    "command": null,
    "entry_url": null,
    "kind": "http_api",
    "method": "POST",
    "requirements": [
      "\u5DF2\u5B58\u5728\u7684\u9002\u7528\u7D22\u5F15\u53CA\u5176\u771F\u5B9E INDEX_HOST",
      "\u6709\u6548\u8D26\u6237 API key",
      "\u4E0E\u7D22\u5F15\u4E00\u81F4\u7684\u5411\u91CF\u7EF4\u5EA6\u6216\u5DF2\u6709\u5411\u91CF ID",
      "\u6309\u5B9E\u9645 API \u7248\u672C\u548C\u7D22\u5F15\u80FD\u529B\u6838\u5BF9\u53C2\u6570"
    ]
  },
  "limitations": [
    "\u672A\u6CE8\u518C key\u3001\u521B\u5EFA\u6216\u4FEE\u6539\u7D22\u5F15\u3001\u751F\u6210 embedding\u3001\u5199\u5165\u6216\u67E5\u8BE2\u5411\u91CF\u3002",
    "INDEX_HOST \u662F\u7528\u6237\u7D22\u5F15\u4E13\u5C5E\u5730\u5740\uFF0C\u5F53\u524D\u6CA1\u6709\u53EF\u786E\u8BA4\u7684\u516C\u5F00\u901A\u7528\u67E5\u8BE2 URL\u3002",
    "\u8FD9\u4E2A /query \u5951\u7EA6\u8F93\u5165\u5411\u91CF\u6216 ID\uFF0C\u4E0D\u8BC1\u660E\u81EA\u52A8\u63A5\u6536\u539F\u59CB\u6587\u672C\u751F\u6210\u5411\u91CF\u6216\u5B8C\u6210\u6574\u5957 RAG\u3002",
    "\u8FD4\u56DE values/metadata \u9ED8\u8BA4\u5173\u95ED\uFF0C\u589E\u52A0\u8FD4\u56DE\u5411\u91CF\u53EF\u80FD\u6709\u5EF6\u8FDF\u5F71\u54CD\u3002",
    "\u5F53\u524D\u53C2\u8003\u7248\u672C\u4E0E\u5B9E\u9645\u670D\u52A1\u652F\u6301\u3001\u7D22\u5F15\u7C7B\u578B\u548C\u8D26\u6237\u8BA1\u8D39\u9700\u8981\u5206\u522B\u6838\u5BF9\u3002"
  ],
  "outputs": [
    "\u6309\u76F8\u4F3C\u5EA6\u6392\u5217\u7684 matches\u3001ID \u548C score",
    "\u6309 includeValues/includeMetadata \u9009\u62E9\u7684\u9644\u52A0\u5B57\u6BB5",
    "namespace \u53CA\u6587\u6863\u5217\u51FA\u7684 usage/read_units \u5143\u6570\u636E"
  ],
  "pricing": {
    "model": "unknown",
    "notes": "\u54CD\u5E94\u6709 read_units \u7528\u91CF\u8BF4\u660E\uFF0C\u4F46\u672C\u9875\u6CA1\u6709\u5B8C\u6574\u8D26\u6237\u4EF7\u683C\u3001\u514D\u8D39\u989D\u5EA6\u6216\u6570\u5B57\u541E\u5410\u653F\u7B56\uFF1B\u4E0D\u5C06\u67E5\u8BE2\u793A\u4F8B\u5F53\u96F6\u6210\u672C\u3002",
    "source_url": null
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [],
  "sources": [
    {
      "basis": "public_record",
      "checked_at": "2026-10-24T17:45:54.4522236\u002B00:00",
      "title": "Search with a vector - Pinecone Docs",
      "url": "https://docs.pinecone.io/reference/api/2024-07/data-plane/query"
    }
  ],
  "summary": "\u5BF9\u81EA\u6709 Pinecone index host \u53D1 POST /query\uFF0C\u4EE5 API key \u548C\u67E5\u8BE2\u5411\u91CF\u6216\u5DF2\u6709\u5411\u91CF ID \u8FD4\u56DE\u76F8\u4F3C\u5339\u914D\u3002\u5F53\u524D\u53EA\u6574\u7406 2024-07 \u7248\u672C\u53C2\u8003\uFF0C\u6CA1\u6709\u5EFA\u7D22\u5F15\u3001\u5199\u5165\u6216\u67E5\u8BE2\u6570\u636E\u3002",
  "tags": [
    "Pinecone",
    "\u5411\u91CF\u68C0\u7D22",
    "HTTP API",
    "API key",
    "\u76F8\u4F3C\u6027\u641C\u7D22"
  ],
  "terms_url": null,
  "title": "Pinecone Query API \u00B7 \u5411\u91CF\u76F8\u4F3C\u6027\u68C0\u7D22",
  "unknowns": [
    "\u5B9E\u9645 INDEX_HOST\u3001\u8D26\u6237\u6743\u9650\u548C\u7D22\u5F15\u914D\u7F6E\u672A\u6838\u5BF9\u3002",
    "\u5F53\u524D\u4EF7\u683C\u3001\u514D\u8D39\u989D\u5EA6\u3001\u541E\u5410\u9650\u5236\u4E0E API \u7248\u672C\u517C\u5BB9\u6027\u672A\u77E5\u3002",
    "\u68C0\u7D22\u76F8\u5173\u6027\u3001\u5EF6\u8FDF\u3001\u6743\u9650\u9694\u79BB\u4E0E\u8F93\u51FA\u8D28\u91CF\u672A\u5B9E\u6D4B\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T17:45:54.4522236\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://docs.pinecone.io/reference/api/2024-07/data-plane/query"
    ],
    "level": "documentation_only",
    "not_verified": [
      "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
    ],
    "outcome": "not_tested",
    "reported_by": "contributor",
    "software_version": null,
    "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
  },
  "schema_version": "navonavo.capability.v1",
  "service_id": "cap-568f806444bda5d5d95034ed",
  "version": 2,
  "source_url": "https://docs.pinecone.io/reference/api/2024-07/data-plane/query",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "url": "https://docs.pinecone.io/reference/api/2024-07/data-plane/query",
    "final_url": "https://docs.pinecone.io/reference/api/2024-07/data-plane/query",
    "status_code": 200,
    "title": "Search with a vector - Pinecone Docs",
    "description": "Search a namespace with a query vector or record ID and return the IDs of the most similar records, along with their similarity scores. For guidance, examples, and limits, see Search.",
    "checked_at": "2026-10-24T17:45:54.4522236\u002B00:00",
    "warnings": [
      "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
    ]
  },
  "created_at": "2026-10-24T17:45:58.3174996\u002B00:00",
  "updated_at": "2026-10-24T17:49:02.2849381\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-568f806444bda5d5d95034ed?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-568f806444bda5d5d95034ed?version=2",
  "verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
  "library_material": {
    "organization": "organized",
    "semantic_state": "classified",
    "semantic_category": "\u6570\u636E\u68C0\u7D22\uFF0FPinecone \u7D22\u5F15\u5411\u91CF\u76F8\u4F3C\u6027\u67E5\u8BE2",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-4b405539559ae7091f5a653af5f69af4",
        "source_url": "https://docs.pinecone.io/reference/api/2024-07/data-plane/query",
        "content_sha256": "2cd36e281f7f58138f3229c6ad2db030916b50adf2c9636f81a2c72588f52a80",
        "decoded_bytes": 923728,
        "content_type": "text/html",
        "captured_at": "2026-10-24T17:45:54.4522236\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "2cd36e281f7f58138f3229c6ad2db030916b50adf2c9636f81a2c72588f52a80",
        "text_utf8_bytes": 923728,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-568f806444bda5d5d95034ed/materials/material-4b405539559ae7091f5a653af5f69af4?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-14aab663c46149249378f8f75b2afb7c",
    "reason": "\u4EC5\u4F9D\u636E\u672C\u6B21\u5DF2\u4FDD\u5B58\u5B98\u65B9\u516C\u5F00\u6B63\u6587\u6574\u7406\u7528\u9014\u3001\u5165\u53E3\u3001\u6761\u4EF6\u548C\u672A\u77E5\u9879\uFF1B\u4FDD\u7559\u539F\u6587\u8BC1\u636E\uFF0C\u4E0D\u5C06\u8BF4\u660E\u6587\u6863\u5192\u5145\u5B9E\u9645\u63A5\u901A\u3001\u529F\u80FD\u5B9E\u6D4B\u6216\u53EF\u7528\u6027\u4FDD\u8BC1\u3002",
    "source_urls": [
      "https://docs.pinecone.io/reference/api/2024-07/data-plane/query"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-568f806444bda5d5d95034ed",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-568f806444bda5d5d95034ed?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-568f806444bda5d5d95034ed?version=2",
    "profiles": [],
    "warnings": [
      "\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
      "\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
    ]
  }
}

Submit another public source · Privacy and disclosure

Copy for your AI

Copy this text manually if clipboard access is unavailable. Copying does not register, install or connect anything.